Función WdfInterruptGetInfo (wdfinterrupt.h)

  • Artículo

[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)

Consulte también

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT