pci_enable_msix — configure device's MSI-X capability structure
int pci_enable_msix ( | struct pci_dev * dev, |
| struct msix_entry * entries, | |
int nvec); |
struct pci_dev * devpointer to the pci_dev data structure of MSI-X device function
struct msix_entry * entriespointer to an array of MSI-X entries (optional)
int nvecnumber of MSI-X irqs requested for allocation by device driver
Setup the MSI-X capability structure of device function with the number of requested irqs upon its software driver call to request for MSI-X mode enabled on its hardware device function. A return of zero indicates the successful configuration of MSI-X capability structure with new allocated MSI-X irqs. A return of < 0 indicates a failure. Or a return of > 0 indicates that driver request is exceeding the number of irqs or MSI-X vectors available. Driver should use the returned value to re-send its request.