IPowerPolicyCallbackWakeFromSx：：OnArmWakeFromSx 方法 （wudfddi.h）
[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱 開始使用 UMDF。]
驅動程式的 OnArmWakeFromSx 事件回呼函式臂（也就是啟用）裝置，使其可在低功率裝置狀態時觸發喚醒訊號。 喚醒訊號會讓裝置進入其工作狀態 （D0），而系統進入其工作狀態 （S0）。
語法
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
參數
[in] pWdfDevice
代表其中一個驅動程式裝置之裝置物件的 IWDFDevice 介面指標。
傳回值
如果作業成功，OnArmWakeFromSx 回呼函式必須傳回S_OK或其他狀態值，而 SUCCEEDED（狀態） 等於 true。 否則，它必須傳回 SUCCEEDED（狀態） 等於 FALSE的狀態值。
如果 SUCCEEDED（status） 等於 FALSE，架構會呼叫驅動程式的 IPowerPolicyCallbackWakeFromSx：：OnDisarmWakeFromSx 回呼函式。 （架構不會向 PnP 管理員回報裝置失敗。
言論
如果您的驅動程式支援 IPowerPolicyCallbackWakeFromSx 介面，則驅動程式必須提供 OnArmWakeFromSx 回呼函式。
此回呼函式會處理裝置特定作業，讓裝置偵測觸發總線喚醒訊號的外部事件。 內核模式總線驅動程式會處理總線特定作業，例如啟用PCI總線的電源管理事件 （PME） 訊號。
如果驅動程式已註冊 OnArmWakeFromSx 回呼函式，則架構會在裝置仍處於 D0 裝置電源狀態時呼叫它，然後總線驅動程式會降低裝置的電源狀態，但在架構傳送 等候/喚醒 IRP 代表驅動程式。
此程式會依下列順序進行：
- 架構會判斷系統即將進入低功率系統狀態。
- 架構會呼叫驅動程式的 OnArmWakeFromSx 回呼函式。
- 架構會要求驅動程式讓裝置的總線降低裝置的電源。
如需架構呼叫此回呼函式時的詳細資訊，請參閱 UMDF 中的PnP 和電源管理案例。
如果您的裝置不需要特殊的硬體作業來觸發喚醒訊號，您就不需要提供 OnArmWakeFromSx 回呼函式。
如需此回呼函式的詳細資訊，請參閱在 UMDF 型驅動程式 中支援系統 Wake-Up。
要求
| 要求 | 價值 |
|---|---|
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平臺 | 桌面 |
| 最低 UMDF 版本 | 1.9 |
| 標頭 | wudfddi.h （包括 Wudfddi.h） |
另請參閱
IPowerPolicyCallbackWakeFromSx