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 |