HW_INTERRUPT función de devolución de llamada (storport.h)
El controlador storport llama a la rutina de HwStorInterrupt después de que el HBA genere una solicitud de interrupción.
Sintaxis
HW_INTERRUPT HwInterrupt;
BOOLEAN HwInterrupt(
PVOID DeviceExtension
)
{...}
Parámetros
DeviceExtension
Puntero al área de almacenamiento del controlador de miniporte por HBA.
Valor devuelto
Si el controlador de miniporte encuentra que su HBA no ha generar la interrupción, HwStorInterrupt debe devolver FALSE lo antes posible. La rutina de HwStorInterrupt debe devolverse en 50 microsegundos.
Observaciones
El nombre HwStorInterrupt 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_INTERRUPT (
IN PVOID DeviceExtension
);
La rutina HwStorInterrupt debe devolver dentro de 50 microsegundos, idealmente lo más breve posible. Por lo tanto, toda la actividad no tiene que producirse en IRQL elevado debe aplazarse a [HwStorDpcRoutine](nc-storport-hw_dpc_routine.md que se define en el controlador de miniport y se emite mediante StorPortIssueDpc. La latencia del DPC es muy baja y se llamará inmediatamente después de la devolución de IRQL alto.
El controlador de puerto llama a la rutina de HwStorInterrupt en DIRQL.
Ejemplos
Para definir un HwStorInterrupt función de devolución de llamada, 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 Análisis de código para controladores, comprobador de controladores estáticos (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 de HwStorInterrupt denominada MyHwInterrupt, use el tipo HW_INTERRUPT tal como se muestra en este ejemplo de código:
HW_INTERRUPT MyHwInterrupt;
A continuación, implemente la rutina de devolución de llamada de la siguiente manera:
_Use_decl_annotations_
BOOLEAN
MyHwInterrupt (
_In_ PVOID DeviceExtension
);
{
...
}
El tipo de función HW_INTERRUPT 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_INTERRUPT 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 rol de función para controladores de Storport. Para obtener información sobre Use_decl_annotations, vea Anotación del comportamiento de la función.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | storport.h (incluya Storport.h) |
| irQL | DIRQL |
Consulte también
[HwStorDpcRoutine](nc-storport-hw_dpc_routine.md