HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE función de devolución de llamada (storport.h)

Artículo
08/07/2023

La rutina HwMSInterruptRoutine controla una interrupción señalada de mensaje (MSI).

Sintaxis

HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE HwMessageSignaledInterruptRoutine;

BOOLEAN HwMessageSignaledInterruptRoutine(
  IN PVOID HwDeviceExtension,
  IN ULONG MessageId
)
{...}

Parámetros

HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

MessageId

Identificador del mensaje.

Valor devuelto

HwMSInterruptRoutine devuelve TRUE si determina que el HBA generó el MSI. Si el HBA no generaba msi, HwMSInterruptRoutine devuelve FALSE.

Comentarios

Una rutina HwMSInterruptRoutine del controlador de miniporte procesa interrupciones señaladas (MSA) generadas por el HBA. Un controlador de minipuerto indica que su HBA genera MSIs estableciendo el miembro HwMSInterruptRoutine de la estructura de PORT_CONFIGURATION_INFORMATION para que apunte a la rutina HwMSInterruptRoutine . Si el HBA no genera MSIs, un controlador de minipuerto debe establecer HwMSInterruptRoutine en NULL.

Si el miembro InterruptSynchronizationMode de la estructura de PORT_CONFIGURATION_INFORMATION se establece en InterruptSynchronizeAll, el controlador storport sincroniza todos los MSIs que se originan con el adaptador que administra o los dispositivos conectados al adaptador. Cuando se produce una interrupción, el controlador storport llama a la rutina HwMSInterruptRoutine del controlador de miniport en DIRQL después de adquirir el bloqueo de giro de interrupción.

Si el miembro InterruptSynchronizationMode de la estructura de PORT_CONFIGURATION_INFORMATION se establece en InterruptSynchronizePerMessage, el controlador storport llama a la rutina HwMSInterruptRoutine del controlador de miniport en IRQL = DIRQL, manteniendo el bloqueo de número de interrupción que corresponde al identificador de mensaje (ID) indicado en el parámetro MessageID . El HBA puede interrumpir la rutina HwMSInterruptRoutine para las interrupciones de otros identificadores de mensaje, por lo que el controlador Storport puede realizar llamadas anidadas a HwMSInterruptRoutine o ejecutar diferentes instancias de HwMSInterruptRoutine simultáneamente en diferentes procesadores. Para sincronizar el acceso a datos confidenciales por diferentes instancias de HwMSInterruptRoutine, el miniport debe llamar a las rutinas StorPortAcquireMSISpinLock y StorPortReleaseMSISpinLock para adquirir y liberar los bloqueos de número de los identificadores de mensaje distintos del identificador de MessageID.

Un controlador de minipuerto puede recuperar información adicional sobre el mensaje llamando a la rutina StorPortGetMSIInfo .

No debe llamar a la rutina StorPortGetMSIInfo desde dentro de la rutina HwMSInterruptRoutine .

El nombre HwMSInterruptRoutine es simplemente un marcador de posición. El prototipo real de esta rutina se define en Storport.h de la siguiente manera:

typedef
BOOLEAN
  HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE (
    _In_ PVOID  HwDeviceExtension,
    _In_ ULONG  MessageId
    );

Ejemplos

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

Por ejemplo, para definir una rutina de devolución de llamada HwMSInterruptRoutine denominada MyHwMSIRoutine, use el tipo de HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE como se muestra en este ejemplo de código:

HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE MyHwMSIRoutine;

A continuación, implemente la rutina de devolución de llamada de la siguiente manera:

_Use_decl_annotations_
BOOLEAN
MyHwMSIRoutine (
  _In_ PVOID  DeviceExtension,
  _In_ ULONG  MessageId
  );
  {
      ...
  }

El tipo de función HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE se define en el archivo de encabezado Storport.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 HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de roles de función para controladores storport. Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.