EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED回调函数 (wdfdevice.h)
[适用于 KMDF 和 UMDF]
驱动程序的 EvtDeviceD0ExitPreInterruptsDisabled 事件回调函数执行特定于设备的作,这些作在驱动程序禁用设备的硬件中断之前需要执行。
语法
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;
NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
[in] WDFDEVICE Device,
[in] WDF_POWER_DEVICE_STATE TargetState
)
{...}
参数
[in] Device
框架设备对象的句柄。
[in] TargetState
一个 WDF_POWER_DEVICE_STATE类型枚举器,用于标识设备即将输入的设备电源状态。
返回值
如果 EvtDeviceD0ExitPreInterruptsDisabled 回调函数遇到任何错误,则它必须返回 STATUS_SUCCESS NT_SUCCESS(状态)等于 TRUE的其他状态值。 否则,它必须返回一个状态值,NT_SUCCESS(状态)等于 FALSE。
有关此回调函数的返回值的详细信息,请参阅 报告设备故障。
言论
若要注册 EvtDeviceD0ExitPreInterruptsDisabled 回调函数,驱动程序必须调用 WdfDeviceInitSetPnpPowerEventCallbacks。
在框架调用驱动程序的 EvtInterruptDisable 回调函数之前,在 IRQL = PASSIVE_LEVEL 调用 EvtDeviceD0ExitPreInterruptsDisable 回调函数。 如果驱动程序在禁用中断之前必须执行特定于设备的作,则驱动程序可以提供此函数,如果不应在 EvtInterruptDisable 回调函数中的 IRQL = DIRQL 执行这些作。
有关框架何时调用此回调函数的详细信息,请参阅 PnP 和电源管理方案。
有关处理中断的详细信息,请参阅 处理硬件中断。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfdevice.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL(请参阅“备注”部分) |