3. MSI-X 中断配置核心数据结构

在 PCIe 多队列驱动中，MSI-X 中断的配置与管理依赖于三个核心数据结构：struct msix_entry、struct msi_desc 以及 pci_dev 中的中断相关字段。理解这三者的角色与关系，是实现高效中断分发的基础。

3.1 struct msix_entry：驱动侧的配置接口

该结构体定义在 include/linux/pci.h 中，是驱动申请 MSI-X 中断时使用的核心参数结构。每个 MSI-X 向量对应一个 msix_entry 实例。

struct msix_entry {
    u32  vector;    /* 内核分配的中断向量号（返回时填充） */
    u16  entry;     /* MSI-X 表项索引（驱动指定） */
};

3.2 struct msi_desc：内核侧的描述符

每个 MSI/MSI-X 向量在内核中对应一个 struct msi_desc 实例，该结构体是内核中断子系统的内部管理单元，驱动通常不直接操作，但理解其字段有助于调试和性能分析。

struct msi_desc {
    struct list_head    list;           /* 链表节点，串联所有 MSI 描述符 */
    unsigned long       irq;            /* Linux 中断号 */
    unsigned int        nvec_used;      /* 该描述符使用的连续向量数（MSI 多向量时 >1） */
    union {
        struct {
            u32 __iomem *mask_base;     /* MSI-X 掩码寄存器基地址 */
            u8          mask_pos;       /* MSI 掩码寄存器偏移 */
        } msi_mask;
        struct {
            u8  entry_nr;               /* MSI-X 表项索引 */
            u8  default_irq;            /* 默认中断号 */
        } msix;
    };
    struct device        *dev;          /* 指向所属设备 */
    struct msi_msg       msg;           /* 存储 Address/Data 消息 */
};

3.3 pci_dev 中的中断相关字段

struct pci_dev 是 PCI 设备的软件抽象，其中包含多个与中断配置直接相关的字段，驱动在初始化阶段需要读取或设置这些字段。

struct pci_dev {
    ...
    unsigned int    irq;                /* 传统 INTx 中断号（或 MSI 单向量时的中断号） */
    struct msi_desc *msi_list;          /* 指向该设备 MSI/MSI-X 描述符链表的头节点 */
    unsigned int    msi_enabled:1;      /* MSI 已启用标志 */
    unsigned int    msix_enabled:1;     /* MSI-X 已启用标志 */
    unsigned int    msix_nr_entries;    /* 设备支持的 MSI-X 向量总数（从 Capability 读取） */
    ...
};

3.4 数据结构关系图

下图展示了驱动、内核与 PCI 设备之间，三个核心数据结构在 MSI-X 中断配置过程中的协作关系：

3.5 关键流程：从申请到绑定

1. 查询能力：读取 pci_dev->msix_nr_entries，确认设备支持的 MSI-X 向量总数。
2. 准备配置：分配 struct msix_entry entries[nvec]，设置每个 entries[i].entry = i。
3. 申请向量：调用 pci_enable_msix_exact() 或 pci_alloc_irq_vectors()，内核创建 msi_desc 并填充 vector。
4. 注册中断：使用 entries[i].vector 调用 request_irq()，绑定每个队列的中断处理函数。
5. 设置亲和性：通过 irq_set_affinity_hint() 将每个向量绑定到指定 CPU 核心。