EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
Las de un controlador EvtDeviceD0ExitPreInterruptsDisabled función de devolución de llamada de eventos realizan operaciones específicas del dispositivo necesarias antes de que el controlador deshabilite las interrupciones de hardware del dispositivo.
Sintaxis
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;
NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
[in] WDFDEVICE Device,
[in] WDF_POWER_DEVICE_STATE TargetState
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] TargetState
Enumerador con tipo WDF_POWER_DEVICE_STATEque identifica el estado de alimentación del dispositivo que el dispositivo está a punto de introducir.
Valor devuelto
Si la función de devolución de llamada EvtDeviceD0ExitPreInterruptsDisabled no encuentra ningún error, debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(estado) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.
Para obtener más información sobre los valores devueltos de esta función de devolución de llamada, consulte Informes de errores de dispositivo.
Observaciones
Para registrar una función de devolución de llamada EvtDeviceD0ExitPreInterruptsDisabled, un controlador debe llamar a WdfDeviceInitSetPnpPowerEventCallbacks.
La función de devolución de llamada EvtDeviceD0ExitPreInterruptsDisabled se llama a la función de devolución de llamada IRQL = PASSIVE_LEVEL, antes de que el marco llame a la función de devolución de llamada EvtInterruptDis able del controlador. Un controlador puede proporcionar esta función si debe realizar operaciones específicas del dispositivo antes de deshabilitar una interrupción, si esas operaciones no deben realizarse en IRQL = DIRQL en el EvtInterruptDisable función de devolución de llamada.
Para obtener más información sobre cuándo el marco llama a esta función de devolución de llamada, consulte escenarios de PnP y Administración de energía.
Para obtener más información sobre el control de interrupciones, consulte Control de interrupciones de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL (consulte la sección Comentarios) |