EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED回调函数 (wdfdevice.h)

项目
02/29/2024

[适用于 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 回调函数中检查该状态，因为始终在设备唤醒后调用该回调，即使唤醒信号已丢弃也是如此。

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