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 调用 EvtDeviceD0ExitPreInterruptsDisabled 回调函数。 如果驱动程序在禁用中断之前必须执行特定于设备的操作，如果不应在 EvtInterruptDisable 回调函数的 IRQL = DIRQL 下执行这些操作，则驱动程序可以提供此函数。

有关框架何时调用此回调函数的详细信息，请参阅 PnP 和电源管理方案。

有关处理中断的详细信息，请参阅 处理硬件中断。

要求

要求	值
目标平台	通用
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
标头	wdfdevice.h (包括 Wdf.h)
IRQL	PASSIVE_LEVEL (请参阅备注部分)

另请参阅

EvtDeviceD0EntryPostInterruptsEnabled