EVT_WDF_INTERRUPT_DISABLE función de devolución de llamada (wdfinterrupt.h)

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos evtInterruptDisable de un controlador deshabilita una interrupción de hardware especificada.

Sintaxis

EVT_WDF_INTERRUPT_DISABLE EvtWdfInterruptDisable;

NTSTATUS EvtWdfInterruptDisable(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFDEVICE AssociatedDevice
)
{...}

Parámetros

[in] Interrupt

Identificador de un objeto de interrupción del marco.

[in] AssociatedDevice

Identificador del objeto de dispositivo de marco que el controlador pasó a WdfInterruptCreate.

Valor devuelto

La función de devolución de llamada EvtInterruptDisable debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(estado) es igual a TRUE si la función no encuentra ningún error. De lo contrario, esta función debe devolver un valor de estado para el que NT_SUCCESS(estado) es igual a FALSE.

Observaciones

Para registrar una función de devolución de llamada de EvtInterruptDisable, el controlador debe colocar la dirección de la función de devolución de llamada en una estructura de WDF_INTERRUPT_CONFIG antes de llamar a WdfInterruptCreate.

El marco llama a la evtInterruptDisable del controlador función de devolución de llamada cada vez que el dispositivo deja su estado de trabajo (D0). Además, un controlador puede hacer que el marco llame a la función de devolución de llamada EvtInterruptDisable llamando a WdfInterruptDisable. Tenga en cuenta que la mayoría de los controladores basados en marcos no deben llamar a WdfInterruptDisable, ya que el marco llama al evtInterruptDisable función de devolución de llamada cada vez que el dispositivo deja su estado de trabajo (D0).

Antes de llamar a la EvtInterruptDisable función de devolución de llamada, el marco genera el IRQL del procesador al DIRQL del dispositivo y adquiere el bloqueo de giro que el controlador especificó en la estructura WDF_INTERRUPT_CONFIG del objeto de interrupción.

A partir de la versión 1.11 de KMDF, el controlador puede proporcionar control de interrupciones de nivel pasivo. Si el controlador ha solicitado el control de interrupciones de nivel pasivo, antes de llamar al función EvtInterruptDisable en IRQL = PASSIVE_LEVEL, el marco adquiere el bloqueo de interrupción de nivel pasivo que el controlador configuró en la estructura de WDF_INTERRUPT_CONFIG del objeto de interrupción.

Antes de llamar a la función de devolución de llamada EvtInterruptDisable, el marco llama a la función de devolución de llamada de eventos EvtDeviceD0ExitPreInterruptsDisabled en IRQL = PASSIVE_LEVEL.

Para obtener más información sobre el control de interrupciones en controladores basados en marcos, consulte control de interrupciones de hardware.

Requisitos

Consulte también

EvtDeviceD0ExitPreInterruptsDisabled

EvtInterruptEnable

WDF_INTERRUPT_CONFIG

WdfInterruptCreate

WdfInterruptDisable