EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED回调函数 (wdfdevice.h)

项目
02/29/2024

[适用于 KMDF 和 UMDF]

驱动程序的 EvtDeviceWakeFromS0Triggered 事件回调函数通知驱动程序，其设备之前在系统电源状态保持为 S0 时进入低功耗设备状态，可能已触发唤醒信号。

语法

EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;

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

参数

[in] Device

框架设备对象的句柄。

返回值

无

备注

若要注册 EvtDeviceWakeFromS0Triggered 回调函数，驱动程序必须调用 WdfDeviceInitSetPowerPolicyEventCallbacks。

如果驱动程序已注册此回调，框架在调用驱动程序的 EvtDeviceD0Entry 回调函数之后，并在调用驱动程序的 EvtDeviceDisarmWakeFromS0 回调函数之前调用它。

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

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

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