Función NdisMConfigMSIXTableEntry (ndis.h)
La función NdisMConfigMSIXTableEntry realiza operaciones de configuración para MSI-X entradas de tabla para mensajes de 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 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 |
|---|---|
|
La entrada MSI-X tabla se ha reconfigurado correctamente. |
|
NdisMConfigMSIXTableEntry produjo un error porque uno o varios miembros de la NDIS_MSIX_CONFIG_PARAMETERS estructura no eran válidas. |
Observaciones
Los controladores de miniporte NDIS que admiten MSI-X llaman a la función NdisMConfigMSMConfigMSIXTableEntry para enmascarar, desenmascarar o asignar MSI-X entradas de tabla a mensajes de MSI-X asignados por el dispositivo. Los controladores de miniport que admiten RSS usan NdisMConfigMSIXTableEntry para cambiar la afinidad de CPU de MSI-X entradas de tabla en tiempo de ejecución.
NdisMConfigMSIXTableEntry es un contenedor alrededor del 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 miniporte puede establecer la afinidad de CPU de MSI-X recursos de interrupción 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 n MSI-X (donde n es el número de entradas de tabla MSI-X que la NIC había notificado al bus) a la primera n MSI-X mensajes en los recursos modificados. Después de llamar a NDIS MiniportInitializeEx, cuando el controlador de miniporte cambia el procesador de destino de una entrada de tabla de MSI-X determinada, el controlador llama a NdisMConfigMSIXTableEntry para asignar esa entrada de tabla a un mensaje de MSI-X que ya tiene la afinidad establecida en el procesador deseado.
Para la operación de NdisMSIXTableConfigSetTableEntry, los autores de llamadas de NdisMConfigMSIXTableEntry deben ejecutarse en IRQL <= DISPATCH_LEVEL.
Para las operaciones de NdisMSIXTableConfigMaskTableEnt ryEntry o NdisMSIXTableConfigUnmaskTableEntry, los autores de llamadas de NdisMConfigMSIXTableEntry se pueden ejecutar en cualquier IRQL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 6.1 y versiones posteriores. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | Consulte la sección Comentarios. |