IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered 方法 (wudfddi.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,而且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
驅動程式的 OnWakeFromSxTriggered 事件回呼函式會通知驅動程式,其裝置先前已進入低電源裝置狀態,因為系統電源已降低,所以可能會觸發喚醒訊號。
語法
void OnWakeFromSxTriggered(
[in] IWDFDevice *pWdfDevice
);
參數
[in] pWdfDevice
代表其中一個驅動程式裝置之裝置物件的 IWDFDevice 介面指標。
傳回值
無
備註
如果驅動程序支援 IPowerPolicyCallbackWakeFromSx 介面,則驅動程式必須提供 OnWakeFromSxTriggered 回呼函式。
如果驅動程式已註冊此回呼,架構會在呼叫驅動程式的 IPnpCallback::OnD0Entry 回呼函式之後,以及在呼叫驅動程式的 IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx 回呼函式之前呼叫它。
系統硬體 (BIOSes、主機板、總線適配卡) 有時會在總線驅動程式偵測到它之前卸除喚醒訊號,即使訊號喚醒系統也一樣。 在這種情況下,即使驅動程式的裝置觸發喚醒訊號,驅動程式的 OnWakeFromSxTriggered 回呼函式也不會呼叫。
如需此回呼函式的詳細資訊,請參閱 支援 UMDF 型驅動程式中的系統 Wake-Up。
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.9 |
標頭 | wudfddi.h (包括 Wudfddi.h) |
另請參閱
IPowerPolicyCallbackWakeFromSx