Función WdfInterruptGetInfo (wdfinterrupt.h)
[Se aplica a KMDF y UMDF]
El método WdfInterruptGetInfo recupera información sobre una interrupción especificada.
Sintaxis
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
Parámetros
[in] Interrupt
Identificador del objeto de interrupción.
[in, out] Info
Puntero a una estructura de WDF_INTERRUPT_INFO asignada por el autor de la llamada que se ha inicializado mediante una llamada a WDF_INTERRUPT_INFO_INIT.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
El método WdfInterruptGetInfo solo puede obtener información de interrupción si el controlador lo llama después de que el marco haya llamado a la función de devolución de llamada EvtDevicePrepareHardware del controlador y antes de que el marco haya llamado a la función de devolución de llamada EvtDeviceReleaseHardware del controlador.
Una vez devuelto WdfInterruptGetInfo , el controlador puede identificar objetos de interrupción de nivel pasivo examinando el miembro Irql de la estructura WDF_INTERRUPT_INFO . En el caso de los objetos de interrupción de nivel pasivo, este valor es PASSIVE_LEVEL.
Para obtener información sobre el orden en el que se llama a las funciones de devolución de llamada de un controlador, consulte Escenarios de administración de energía y PnP.
Para obtener más información sobre el control de interrupciones en controladores basados en marcos, consulte Control de interrupciones de hardware.
Ejemplos
En el ejemplo de código siguiente se inicializa una estructura de WDF_INTERRUPT_INFO y se llama a WdfInterruptGetInfo.
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfinterrupt.h (incluir Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf) |