EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED回调函数 (wdfdevice.h)

[适用于 KMDF 和 UMDF]

驱动程序的 EvtDeviceWakeFromSxTriggered 事件回调函数通知驱动程序,其设备可能触发了唤醒信号,该设备之前由于系统功率降低而进入低功率设备状态。

语法

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

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

参数

[in] Device

框架设备对象的句柄。

返回值

备注

若要注册 EvtDeviceWakeFromSxTriggered 回调函数,驱动程序必须调用 WdfDeviceInitSetPowerPolicyEventCallbacks

如果驱动程序已注册此回调,则框架在调用驱动程序的 EvtDeviceD0Entry 回调函数之后和调用驱动程序的 EvtDeviceDisarmWakeFromSx 回调函数之前调用它。

系统硬件 (BIOSes、主板、总线适配器) 有时可以在总线驱动程序检测到唤醒信号之前丢弃唤醒信号,即使信号唤醒系统也是如此。 在这种情况下,即使驱动程序的设备触发了唤醒信号,也不会调用驱动程序的 EvtDeviceWakeFromSxTriggered 回调函数。

一些公共汽车结合了几个孩子的唤醒信号。 如果设备连接到其中一个总线,则回调函数可能必须确定当前设备是否触发了唤醒信号。 如果设备提供的硬件闩锁来保存设备的触发状态,则最好在驱动程序的 EvtDeviceDisarmWakeFromSx 回调函数中检查该状态,因为始终在设备唤醒后调用该回调,即使唤醒信号已丢弃也是如此。

有关此回调函数的详细信息,请参阅 支持系统唤醒

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL

另请参阅

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx

EvtDeviceWakeFromS0Triggered