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