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

IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx