PCI_MSIX_SET_ENTRY función de devolución de llamada (wdm.h)

  • Artículo

La rutina SetTableEntry establece el identificador de mensaje de una entrada de tabla en la tabla de interrupciones de hardware MSI-X.

Sintaxis

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

NTSTATUS PciMsixSetEntry(
  [in] PVOID Context,
  [in] ULONG TableEntry,
  [in] ULONG MessageNumber
)
{...}

Parámetros

[in] Context

Puntero a información de contexto específica de la interfaz. El autor de la llamada pasa el valor que se pasa como miembro Context de la estructura PCI_MSIX_TABLE_CONFIG_INTERFACE de la interfaz.

[in] TableEntry

Índice de la entrada de tabla en la tabla de interrupciones de hardware MSI-X.

[in] MessageNumber

Identificador del mensaje para la interrupción. Este valor también es el índice de la entrada de la interrupción en el miembro MessageInfo de la estructura IO_INTERRUPT_MESSAGE_INFO que describe las interrupciones señaladas por el mensaje del controlador. La función IoConnectInterruptEx proporciona un puntero a esta estructura.

Valor devuelto

La rutina SetTableEntry puede devolver uno de los siguientes valores NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS
 La operación se ha completado correctamente.
STATUS_INVALID_PARAMETER
 El dispositivo no usa MSI-X o los parámetros TableEntry o MessageNumber no corresponden a recursos de interrupción asignados al dispositivo.

Comentarios

De forma predeterminada, el sistema operativo asigna el índice de la entrada de tabla como identificador de mensaje para la interrupción. Si hay más entradas de tabla que mensajes, el sistema establece las entradas de tabla restantes para que se correspondan con el mensaje cero. El controlador puede usar la rutina SetTableEntry para asignar un identificador de mensaje diferente.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista con Service Pack 1 (SP1), Windows Server 2008 y versiones posteriores del sistema operativo Windows.
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DIRQL

Consulte también

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE