Compartir a través de


Función NdisMConfigMSIXTableEntry (ndis.h)

La función NdisMConfigMSIXTableEntry realiza operaciones de configuración para entradas de tabla MSI-X para mensajes MSI-X asignados por el dispositivo.

Sintaxis

NDIS_STATUS NdisMConfigMSIXTableEntry(
  [in] NDIS_HANDLE                  NdisMiniportHandle,
  [in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);

Parámetros

[in] NdisMiniportHandle

Un controlador de adaptador de miniporte NDIS que NDIS proporcionó a la Función MiniportInitializeEx .

[in] MSIXConfigParameters

Puntero a un autor de llamada asignado NDIS_MSIX_CONFIG_PARAMETERS estructura que define la operación de configuración solicitada y especifica los parámetros necesarios para esa operación concreta.

Valor devuelto

NdisMConfigMSIXTableEntry devuelve un código de error adecuado del controlador de bus PCI subyacente o uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
La entrada de tabla MSI-X se volvió a configurar correctamente.
NDIS_STATUS_INVALID_PARAMETER
Error de NdisMConfigMSIXTableEntry porque uno o varios miembros del NDIS_MSIX_CONFIG_PARAMETERS estructura no eran válidas.

Comentarios

Los controladores de miniporte de NDIS que admiten MSI-X llaman a la función NdisMConfigMSIXTableEntry para enmascarar, desenmascarar o asignar entradas de tabla MSI-X a mensajes MSI-X asignados por el dispositivo. Los controladores de minipuerto que admiten RSS usan NdisMConfigMSIXTableEntry para cambiar la afinidad de CPU de las entradas de tabla MSI-X en tiempo de ejecución.

NdisMConfigMSIXTableEntry es un contenedor alrededor de GUID_MSIX_TABLE_CONFIG_INTERFACE consulta. Los controladores de miniport pueden llamar a NdisMConfigMSIXTableEntry después de que NDIS llame a la función MiniportInitializeEx y antes de que el controlador vuelva de la función MiniportHaltEx .

El controlador de minipuerto puede establecer la afinidad de CPU de los recursos de interrupción MSI-X para que el dispositivo tenga al menos un mensaje MSI-X para cada procesador RSS. Tenga en cuenta que el controlador de bus PCI asigna inicialmente las entradas de tabla MSI-X (donde n es el número de entradas de tabla MSI-X que la NIC había notificado al bus) a los primeros mensajes MSI-X en los recursos modificados. Después de que NDIS llame a MiniportInitializeEx, cuando el controlador de miniporte cambia el procesador de destino de una entrada de tabla MSI-X determinada, el controlador llama a NdisMConfigMSIXTableEntry para asignar esa entrada de tabla a un mensaje MSI-X que ya tiene la afinidad establecida en el procesador deseado.

Para la operación NdisMSIXTableConfigSetTableEntry , los llamadores de NdisMConfigMSIXTableEntry deben ejecutarse en IRQL <= DISPATCH_LEVEL.

Para las operaciones NdisMSMSIXTableConfigMaskTableEntry o NdisMSIXTableConfigUnmaskTableEntry , las llamadas de NdisMConfigMSIXTableEntry se pueden ejecutar en cualquier IRQL.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite en NDIS 6.1 y versiones posteriores.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL Consulte la sección Comentarios.

Consulte también

MiniportHaltEx

MiniportInitializeEx

NDIS_MSIX_CONFIG_PARAMETERS