EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0回调函数 (wdfdevice.h)

  • 项目

[适用于 KMDF 和 UMDF]

驱动程序的 EvtDeviceDisarmWakeFromS0 事件回调函数解除 (即，如果系统保持系统 工作状态 (S0) ，则禁用) 设备在低功耗设备状态下触发唤醒信号的能力。

语法

EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 EvtWdfDeviceDisarmWakeFromS0;

void EvtWdfDeviceDisarmWakeFromS0(
  [in] WDFDEVICE Device
)
{...}

参数

[in] Device

框架设备对象的句柄。

返回值

无

备注

若要注册 EvtDeviceDisarmWakeFromS0 回调函数，驱动程序必须调用 WdfDeviceInitSetPowerPolicyEventCallbacks。 驱动程序还必须在其 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构的 IdleCaps 成员中设置 IdleCanWakeFromS0。

如果驱动程序已注册 EvtDeviceDisarmWakeFromS0 回调函数，则框架在总线驱动程序确定事件已唤醒设备之后，并在总线驱动程序随后完成 等待/唤醒 IRP 后调用它。 在调用驱动程序的 EvtDeviceDisarmWakeFromS0EvtDeviceDisarmWakeFromS0 回调函数之前，框架调用驱动程序的 EvtDeviceD0Entry、 EvtInterruptEnable 和 EvtDeviceWakeFromS0Triggered 回调函数。

EvtDeviceDisarmWakeFromS0 回调函数必须执行所需的任何硬件操作，以禁用设备在电源降低后触发唤醒信号的能力。

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

有关此回调函数的详细信息，请参阅 支持空闲电源关闭。

EvtDeviceDisarmWakeFromS0 回调函数在 IRQL = PASSIVE_LEVEL调用。 不应使此回调函数 可分页。

要求

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

另请参阅

EvtDeviceArmWakeFromS0

EvtDeviceDisarmWakeFromSx