4. MSI-X 数据结构：Message Table、PBA Table、Table Entry 结构详解

MSI-X 的核心优势在于其灵活的数据结构设计。与传统的 MSI 或 INTx 不同，MSI-X 通过一组独立的内存映射表来管理每个中断向量，使得每个中断都可以拥有独立的处理函数和 CPU 亲缘性。本章将深入解析 MSI-X 的三大核心数据结构：Message Table（消息表）、Pending Bit Array (PBA) Table（待处理位数组表）以及 Table Entry（表项）的详细结构。

4.1 MSI-X 整体架构与内存映射

MSI-X 功能通过 PCIe 配置空间中的 MSI-X Capability Structure 进行声明。该结构包含两个关键的基地址寄存器（BAR），分别指向 Message Table 和 PBA Table 在内存中的起始位置。这两个表都位于设备的 MMIO（Memory-Mapped I/O） 地址空间中。

4.2 Message Table Entry 结构详解

每个 Table Entry 的大小固定为 16 字节，分为四个 32-bit 的字段。这是 MSI-X 中断配置的核心，驱动程序通过修改这些字段来控制中断的行为。

4.3 Pending Bit Array (PBA) Table 结构

PBA Table 是一个位图数组，每个位对应一个中断向量。当某个中断向量被 Masked（屏蔽） 时，设备触发的中断不会立即发送，而是将 PBA 中对应的位设置为 1。当该向量被 Unmask（取消屏蔽）后，设备会检查 PBA 表，如果对应位为 1，则立即发送中断消息。

4.4 数据结构配置示例

以下是一个典型的 Linux 内核驱动配置 MSI-X 中断向量的代码片段，展示了如何操作 Message Table 和 Vector Control 字段。

/* 假设 dev 是 pci_dev 结构体指针，entry 是 MSI-X 表项索引 */
static int configure_msix_vector(struct pci_dev *dev, int entry, int cpu)
{
    struct msix_entry msix;
    int ret;

    /* 1. 分配 MSI-X 向量 */
    msix.entry = entry;
    ret = pci_enable_msix_range(dev, &msix, 1, 1);
    if (ret < 0)
        return ret;

    /* 2. 获取该向量的 Message Data 和 Address */
    u32 msg_addr = msix.address;
    u32 msg_data = msix.data;

    /* 3. 修改 Message Address 以绑定到特定 CPU (Destination ID) */
    /* 假设目标 CPU 的 APIC ID 为 cpu_apic_id */
    msg_addr &= ~0xFFF;          /* 清除低 12 位 */
    msg_addr |= (cpu_apic_id << 12); /* 设置 Destination ID */

    /* 4. 写回 Message Table (通过 MMIO 地址) */
    void __iomem *base = dev->msix_base;
    writel(msg_addr, base + entry * 16);
    writel(0, base + entry * 16 + 4);      /* Upper Address */
    writel(msg_data, base + entry * 16 + 8);

    /* 5. 确保向量未被屏蔽 (Vector Control 的 Mask Bit = 0) */
    writel(0, base + entry * 16 + 12);

    return 0;
}

4.5 数据结构对比：MSI vs MSI-X

理解 MSI-X 数据结构的优势，最好的方式是与传统的 MSI 进行对比。