windows网络适配器驱动开发-开发 WiFiCx 客户端驱动程序(八)

电源策略更改对于电源管理客户端驱动程序使用 NETPOWERSETTINGS 对象 例如其他类型的 NetAdapterCx 客户端驱动程序。为了在系统处于工作状态S0状态时支持设备闲置驱动程序调用 WdfDeviceAssignS0IdleSettings 并将 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS的 IdleTimeoutType 成员设置为 SystemManagedIdleTimeoutWithHintconst ULONG WIFI_DEFAULT_IDLE_TIMEOUT_HINT_MS 3u * 1000u; // 3 seconds ... WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS idleSettings; WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(idleSettings,IdleCanWakeFromS0); idleSettings.IdleTimeout WIFI_DEFAULT_IDLE_TIMEOUT_HINT_MS; // 3 seconds idleSettings.IdleTimeoutType SystemManagedIdleTimeoutWithHint; status WdfDeviceAssignS0IdleSettings(DeviceContext-WdfDevice, idleSettings);关于电源策略更改WiFiCx 客户端驱动程序在电源管理方面使用 NETPOWERSETTINGS 对象这与其它类型的 NetAdapterCx 客户端驱动程序是相同的。为了在系统处于工作状态即 S0 状态时支持设备闲置驱动程序需要调用 WdfDeviceAssignS0IdleSettings 函数并将 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构中的 IdleTimeoutType 成员设置为 SystemManagedIdleTimeoutWithHint。当驱动程序这样配置后会产生一个关键效果WDF 框架会代表驱动程序向 Windows 电源管理框架简称 PoFx进行注册。注册之后设备空闲电源管理的主导权就从驱动程序移交给了 PoFx。驱动程序不再直接控制设备何时进入或退出低功耗状态而是由 PoFx 根据系统整体的电源状态和活动情况来统一决策和管理。这种设计实现了职责分离PoFx 负责全局决策即决定何时让设备空闲驱动程序则负责执行具体的电源状态切换操作即如何进入或退出 Dx 状态。作为注册的一部分驱动程序需要提供一系列回调函数例如 EvtDeviceWdmPostPoFxRegisterDevice 等。当 PoFx 决定改变设备电源状态时会通过这些回调通知驱动程序执行相应操作。接下来解释 SystemManagedIdleTimeoutWithHint 中 Hint 的含义。这个 Hint 指的是驱动程序提供的 IdleTimeout 值在示例中为 3000 毫秒也就是 3 秒。这个值并不是一个绝对的超时时间而是给 PoFx 的一个参考建议。PoFx 在决定设备是否空闲时会综合考虑系统内所有组件的状态驱动程序提供的这个超时值只是其中的一个输入PoFx 可能会基于更全局的考量而忽略它。设置此值的主要目的是“防止设备过早进入空闲状态”通过提供一个合理的超时值驱动程序可以避免在短暂的数据传输间隙就频繁地进入和退出低功耗状态从而减少不必要的性能开销。在具体的代码实现中标准流程包括首先使用初始化宏对 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构进行初始化并指定 IdleCanWakeFromS0表明设备在 S0 空闲状态下具备唤醒能力。然后将 IdleTimeout 成员设置为三秒的超时提示值再将 IdleTimeoutType 设置为 SystemManagedIdleTimeoutWithHint这是启用 PoFx 管理的关键步骤。最后调用 WdfDeviceAssignS0IdleSettings 将配置应用到 WDF 设备对象。需要说明的是这段电源策略配置属于 WiFiCx 驱动电源管理的一部分。一个完整的电源管理方案通常还包括注册电源事件回调以接收电源状态转换通知调用 NetAdapterCx 提供的 API 来声明硬件支持的唤醒事件和低功耗协议卸载能力以及通过标准化 INF 关键字允许用户或系统对网络设备的空闲行为进行更精细的控制。在调用 WdfDeviceAssignS0IdleSettings 时还需要注意几个问题调用驱动必须是设备的电源策略所有者否则会返回 STATUS_INVALID_DEVICE_REQUEST如果提供的结构体参数无效会返回 STATUS_INVALID_PARAMETER另外在 Windows 8 及之后的系统中框架会检查系统固件是否支持在 S0 状态下处理唤醒信号如果检查失败函数会返回 STATUS_POWER_STATE_INVALID。此时设备将保持 D0 状态无法进入低功耗模式但驱动程序不应将此视为致命错误可记录日志后继续运行。