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 (狀態) 等於 FALSE，架構會呼叫驅動程式的 IPowerPolicyCallbackWakeFromSx：：OnDisarmWakeFromSx 回 呼函式。 (架構不會向 PnP 管理員回報裝置失敗。)

備註

如果驅動程序支援 IPowerPolicyCallbackWakeFromSx 介面，您的驅動程式必須提供 OnArmWakeFromSx 回呼函式。

此回呼函式會處理裝置特定作業，讓裝置能夠偵測觸發公交車喚醒訊號的外部事件。 核心模式總線驅動程式會處理總線特定的作業，例如啟用PCI總線的電源管理事件 (PME) 訊號。

如果驅動程式已註冊 OnArmWakeFromSx 回呼函式，則當裝置仍在 D0 裝置電源狀態時，架構會在總線驅動程式降低裝置的電源狀態之前呼叫它，但在架構代表驅動程式傳送 等候/喚醒 IRP 之後。

此程式會以下欄順序發生：

1. 架構會判斷系統即將進入低電源系統狀態。
2. 架構會呼叫驅動程式的 OnArmWakeFromSx 回 呼函式。
3. 架構會要求驅動程式輸入裝置的總線，以降低裝置的電源。

在裝置進入低電源狀態之前，架構會呼叫驅動程式的 IPnpCallback：：OnD0Exit 回 呼函式。

如需架構何時呼叫此回呼函式的詳細資訊，請參閱 UMDF 中的 PnP 和電源管理案例。

如果您的裝置不需要特殊的硬體作業來觸發喚醒訊號，您就不需要提供 OnArmWakeFromSx 回呼函式。

如需此回呼函式的詳細資訊，請參閱 支援 UMDF 型驅動程式中的系統 Wake-Up。

規格需求

需求	值
終止支援	在 UMDF 2.0 和更新版本中無法使用。
目標平台	桌面
最低UMDF版本	1.9
標頭	wudfddi.h (包含 Wudfddi.h)

另請參閱

IPowerPolicyCallbackWakeFromSx

IPowerPolicyCallbackWakeFromSx：：OnDisarmWakeFromSx

IPowerPolicyCallbackWakeFromSx：：OnWakeFromSxTriggered