.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "PCI_ENABLE_MSIX" "9" "09 October 2005" "" ""

.SH NAME
pci_enable_msix \- configure device's MSI-X capability structure
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int pci_enable_msix  (struct pci_dev * \fIdev\fB, struct msix_entry * \fIentries\fB, int \fInvec\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIdev\fB\fR
pointer to the pci_dev data structure of MSI-X device function
.TP
\fB\fIentries\fB\fR
pointer to an array of MSI-X entries
.TP
\fB\fInvec\fB\fR
number of MSI-X vectors requested for allocation by device driver
.SH "DESCRIPTION"
.PP
Setup the MSI-X capability structure of device function with the number
of requested vectors 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 vectors. A return of < 0 indicates a failure.
Or a return of > 0 indicates that driver request is exceeding the number
of vectors available. Driver should use the returned value to re-send
its request.