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 |
|---|---|
|
La entrada de tabla MSI-X se volvió a configurar correctamente. |
|
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. |