通过

IPowerPolicyCallbackWakeFromS0：：OnArmWakeFromS0 方法 (wudfddi.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

驱动程序的 OnArmWakeFromS0 回调函数支持 (即启用) 设备，以便在处于低功耗设备状态时触发唤醒信号（如果系统保持工作 状态 (S0) ）。

语法

HRESULT OnArmWakeFromS0(
  [in] IWDFDevice *pWdfDevice
);

参数

[in] pWdfDevice

指向表示驱动程序设备之一的设备对象的 IWDFDevice 接口的指针。

返回值

如果操作成功， OnArmWakeFromS0 回调函数必须返回S_OK或另一个状态值，其 SUCCEEDED (状态) 等于 TRUE。 否则，它必须返回成功 (状态) 等于 FALSE 的状态值。

如果 SUCCEEDED (状态) 等于 FALSE，框架将调用驱动程序的 IPowerPolicyCallbackWakeFromS0：：OnDisarmWakeFromS0 回调函数。 (框架不会向 PnP 管理器报告设备故障。)

注解

如果驱动程序支持 IPowerPolicyCallbackWakeFromS0 接口，则驱动程序必须提供 OnArmWakeFromS0 回调函数。

OnArmWakeFromS0 回调函数处理设备特定的操作，使设备能够检测在总线上触发唤醒信号的外部事件。 内核模式总线驱动程序处理特定于总线的操作，例如启用 PCI 总线的电源管理事件 (PME) 信号。

如果驱动程序已注册 OnArmWakeFromS0 回调函数，框架会在设备仍处于 D0 设备电源状态时调用它，然后总线驱动程序降低设备的电源状态，但在框架代表驱动程序发送 等待/唤醒 IRP 后调用它。

此过程按以下顺序发生：

  1. 框架确定设备在预设时间内处于空闲状态。
  2. 框架调用驱动程序的 OnArmWakeFromS0 回调函数。
  3. 框架请求设备总线的驱动程序以降低设备的功率。
在设备进入低功耗状态之前，框架将立即调用驱动程序的 IPnpCallback：：OnD0Exit 回调函数。

有关框架何时调用此回调函数的详细信息，请参阅 UMDF 中的 PnP 和电源管理方案。

如果设备执行以下操作，则无需提供 OnArmWakeFromS0 回调函数：

  • 支持“选择性挂起”的 USB 设备。
  • 当系统保持完全通电时，无法关闭电源。
  • 不需要使设备能够触发唤醒信号的特殊硬件操作。
如果设备支持 USB“选择性挂起”，并且驱动程序在调用 IWDFDevice2：：AssignS0IdleSettings 时指定 IdleUsbSelectiveSuspend，框架会在设备已空闲一段时间后向 USB 总线驱动程序发送“选择性挂起”请求。

有关此回调函数的详细信息，请参阅 支持基于 UMDF 的驱动程序中的空闲 Power-Down。

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.9
标头 wudfddi.h (包括 Wudfddi.h)

另请参阅

IPowerPolicyCallbackWakeFromS0

IPowerPolicyCallbackWakeFromS0：：OnDisarmWakeFromS0

IPowerPolicyCallbackWakeFromS0：：OnWakeFromS0Triggered