Linux 内核--PCI 设备分配中断向量函数：pci_alloc_irq_vectors

`pci_alloc_irq_vectors` 是一个 Linux 内核函数，用于为 PCI 设备分配中断向量。这个函数允许设备驱动程序为 PCI 设备分配一个或多个中断向量，以便在中断发生时执行特定的处理程序。

`pci_alloc_irq_vectors` 函数的原型如下：
int pci_alloc_irq_vectors(struct pci_dev *dev, unsigned int min_vecs, unsigned int max_vecs, unsigned int flags);

参数：

- `dev`：指向表示 PCI 设备的 `pci_dev` 结构的指针。
- `min_vecs`：要分配的最小中断向量数。
- `max_vecs`：要分配的最大中断向量数。
- `flags`：中断向量分配的标志，用于指定中断向量分配的行为。

返回值：

- 如果成功，返回分配的中断向量数。如果失败，返回一个负数，表示错误代码。

要使用 `pci_alloc_irq_vectors` 函数，您需要在设备驱动程序中分配中断向量，并在驱动程序的 `probe` 函数中请求中断向量。以下是一个简单的示例，演示了如何在 PCI 设备驱动程序中使用 `pci_alloc_irq_vectors`：
#include<linux/module.h>
#include<linux/pci.h>
#include<linux/interrupt.h>

static irqreturn_t my_interrupt_handler(int irq, void *dev_id)
{
    printk(KERN_INFO "Interrupt received\n");
    return IRQ_HANDLED;
}

static int my_pci_probe(struct pci_dev *dev, const struct pci_device_id *id)
{
    int ret;
    int irq;

    // ...

    ret = pci_alloc_irq_vectors(dev, 1, 1, PCI_IRQ_MSI);
    if (ret < 0) {
        printk(KERN_ERR "Failed to allocate IRQ vectors\n");
        return ret;
    }

    irq = pci_irq_vector(dev, 0);
    ret = request_irq(irq, my_interrupt_handler, IRQF_SHARED, "my_pci_driver", dev);
    if (ret) {
        printk(KERN_ERR "Failed to request IRQ\n");
        return ret;
    }

    // ...

    return 0;
}

static const struct pci_device_id my_pci_ids[] = {
    { PCI_DEVICE(0x1234, 0x5678) },
    { 0, }
};

static struct pci_driver my_pci_driver = {
    .name = "my_pci_driver",
    .id_table = my_pci_ids,
    .probe = my_pci_probe,
};

module_pci_driver(my_pci_driver);

在这个示例中，我们使用 `pci_alloc_irq_vectors` 函数为 PCI 设备分配一个中断向量，并在 PCI 设备驱动程序的 `probe` 函数中请求中断向量。然后，我们将中断处理程序与指定的中断向量关联。在中断发生时，`my_interrupt_handler` 函数将被调用。

请注意，在使用完中断向量后，您应该使用 `free_irq` 函数释放中断向量。例如：
free_irq(irq, dev);