MINIPORT_MESSAGE_INTERRUPT función de devolución de llamada (ndis.h)

Artículo
02/29/2024

NDIS llama a la función MiniportMessageInterrupt cuando una NIC genera una interrupción basada en mensajes.

Nota Debe declarar la función mediante el tipo MINIPORT_MESSAGE_INTERRUPT . Para obtener más información, consulte la sección Ejemplos siguientes.

Sintaxis

MINIPORT_MESSAGE_INTERRUPT MiniportMessageInterrupt;

BOOLEAN MiniportMessageInterrupt(
  [in]  NDIS_HANDLE MiniportInterruptContext,
  [in]  ULONG MessageId,
  [out] PBOOLEAN QueueDefaultInterruptDpc,
  [out] PULONG TargetProcessors
)
{...}

Parámetros

[in] MiniportInterruptContext

Identificador de un bloque de información de contexto de interrupción. El controlador de minipuerto proporcionó este controlador en el parámetro MiniportInterruptContext que el controlador de miniporte pasó al Función NdisMRegisterInterruptEx .

[in] MessageId

Identificador de mensaje de interrupción con señal de mensaje (MSI). MessageId es un índice de un IO_INTERRUPT_MESSAGE_INFO_ENTRY estructura dentro de IO_INTERRUPT_MESSAGE_INFO estructura. NDIS pasa un puntero a la estructura de IO_INTERRUPT_MESSAGE_INFO asociada en el miembro MessageInfoTable cuando el controlador se registra correctamente para MSI con la función NdisMRegisterInterruptEx .

[out] QueueDefaultInterruptDpc

Puntero a una variable booleana que establece el controlador de miniporte antes de volver desde esta llamada. Un controlador de minipuerto establece este valor en TRUE para indicar que el controlador requiere un DPC en la CPU predeterminada (actual). Si se establece en TRUE, NDIS omite el valor del parámetro TargetProcessors . Si se establece en FALSE, NDIS usa el valor del parámetro TargetProcessors para programar DPC.

[out] TargetProcessors

Máscara de bits que indica los procesadores de destino para los que NDIS debe programar un DPC. Esta máscara de bits representa los primeros 32 procesadores del grupo de procesadores 0. Cada bit de la máscara de bits identifica una CPU. Si el autor de la llamada establece el bit 0, NDIS programa un DPC para la CPU 0. Si el autor de la llamada establece el bit 1, NDIS programa un DPC para la CPU 1, etc.

Nota Los controladores NDIS 6.20 y versiones posteriores no deben usar este parámetro para programar DPC. En su lugar, deben establecer este parámetro en cero y usar la función NdisMQueueDpcEx para programar DPC.

Valor devuelto

MiniportMessageInterrupt devuelve TRUE si la NIC subyacente generó la interrupción; de lo contrario, devuelve FALSE.

Comentarios

Los controladores de miniport que se registran para la compatibilidad con interrupciones señaladas por mensajes (MSI) con la función NdisMRegisterInterruptEx deben proporcionar una función MiniportMessageInterrupt .

Un controlador de minipuerto debe realizar el menor trabajo posible en su función MiniportMessageInterrupt . Debe aplazar las operaciones de E/S para las interrupciones que genera la NIC a la Función MiniportMessageInterruptDPC .

Cuando una NIC genera un MSI, NDIS llama a la función MiniportMessageInterrupt del controlador de miniport.

MiniportMessageInterrupt guarda la información de estado necesaria sobre la interrupción y aplaza la mayor parte del procesamiento de E/S posible a la Función MiniportMessageInterruptDPC .

Si el controlador de miniporte solicita llamadas a procedimiento diferido (DPC) para un mensaje especificado, el controlador de miniporte debe deshabilitar todas las interrupciones adicionales para ese mensaje y volver a habilitar las interrupciones una vez finalizadas todas las DPC.

El controlador de minipuerto debe establecer QueueDefaultInterruptDpc en TRUE para programar un DPC solo para la CPU predeterminada. El controlador puede hacerlo, por ejemplo, si:

La NIC generó la interrupción para indicar la finalización de una operación de envío o cualquier otra solicitud que no se ejecute en otras CPU.
La NIC generó la interrupción para indicar los datos recibidos y el controlador de minipuerto no puede procesar paquetes recibidos en DPC independientes.
La interrupción indica que los paquetes recibidos y el controlador de miniporte pueden procesar paquetes recibidos en DPC independientes, pero el escalado lateral de recepción (RSS) no está habilitado para el controlador de minipuerto. Para obtener más información, vea OID_GEN_RECEIVE_SCALE_CAPABILITIES y OID_GEN_RECEIVE_SCALE_PARAMETERS.
El escalado lateral de recepción está habilitado para el controlador de minipuerto y el controlador de minipuerto puede generar mensajes diferentes en cada cola de recepción.

Si un controlador de minipuerto procesa paquetes recibidos en DPC independientes, el controlador de minipuerto establece el parámetro QueueDefaultInterruptDpc en FALSE. El controlador de minipuerto debe establecer el bit TargetProcessors para la CPU asociada a cada cola de recepción no vacía. NDIS programará un DPC en cada una de las CPU indicadas en el grupo de procesadores 0.

Si MiniportMessageInterrupt comparte recursos para un mensaje especificado, como registros de NIC o variables de estado, con otra función MiniportXxx que se ejecuta en un IRQL inferior, esa función MiniportXxx debe llamar a la Función NdisMSynchronizeWithInterruptEx . Esto garantiza que la función MiniportSynchronizeMessageInterrupt del controlador tenga acceso a los recursos compartidos de una manera sincronizada y segura para varios procesadores.

Un controlador de minipuerto puede llamar a Función NdisMDeregisterInterruptEx de su función MiniportInitializeEx o MiniportHaltEx para liberar recursos asignados con NdisMRegisterInterruptEx. Después de que se devuelva NdisMDeregisterInterruptEx , NDIS no llama a la función MiniportMessageInterrupt o MiniportMessageInterruptDPC del controlador de miniport.

NDIS llama a MiniportMessageInterrupt en el DIRQL del MSI que el controlador de miniporte registró en una llamada anterior a NdisMRegisterInterruptEx. Por lo tanto, MiniportMessageInterrupt debe llamar al subconjunto de las funciones NDIS, como las funciones NdisRawXxx o NdisRead/WriteRegisterXxx, que son seguras para llamar a en cualquier IRQL.

Ejemplos

Para definir una función MiniportMessageInterrupt , primero debe proporcionar una declaración de función que identifique el tipo de función que está definiendo. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función MiniportMessageInterrupt denominada "MyMessageInterrupt", use el tipo de MINIPORT_MESSAGE_INTERRUPT como se muestra en este ejemplo de código:

MINIPORT_MESSAGE_INTERRUPT MyMessageInterrupt;

A continuación, implemente la función de la siguiente manera:

_Use_decl_annotations_
BOOLEAN
 MyMessageInterrupt(
    NDIS_HANDLE  MiniportInterruptContext,
    ULONG  MessageId,
    PBOOLEAN  QueueDefaultInterruptDpc,
    PULONG  TargetProcessors
    )
  {...}

El tipo de función MINIPORT_MESSAGE_INTERRUPT se define en el archivo de encabezado Ndis.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función MINIPORT_MESSAGE_INTERRUPT en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea Declarar funciones mediante tipos de roles de función para controladores NDIS.

Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	Consulte la sección Comentarios.