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 回呼函式中的該狀態,因為即使喚醒訊號已卸除,仍會呼叫該回呼。
如需此回呼函式的詳細資訊,請參閱 支援系統喚醒。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最小 KMDF 版本 | 1.0 |
最低UMDF版本 | 2.0 |
標頭 | wdfdevice.h (包含 Wdf.h) |
IRQL | PASSIVE_LEVEL |