电源管理的标准化 INF 关键字
电源管理标准化关键字在设备驱动程序 INF 文件中定义。 操作系统读取这些标准化关键字,并调整设备的当前电源管理功能。
网络适配器 WDF 类扩展 (NetAdapterCx) 客户端驱动程序和传统的 NDIS 微型端口设备驱动程序都使用这些电源管理关键字。 但是,某些关键字由 NetAdapterCx 驱动程序专门使用,而其他关键字则由 NDIS 驱动程序独占使用,如以下部分所述:
传统的 NDIS 微型端口设备驱动程序应始终在 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 结构中向 NDIS 指示设备的硬件电源管理功能。
有关标准化 INF 关键字的详细信息,请参阅 网络设备的标准化 INF 关键字。
NetAdapterCx 和 NDIS 的电源管理关键字
定义了以下标准化 INF 关键字,以启用或禁用对网络适配器的电源管理功能的支持。 NetAdapterCx 客户端驱动程序和传统的 NDIS 微型端口设备驱动程序都使用它们。
*WakeOnPattern
一个 值,该值描述当网络数据包与指定模式匹配时,是否应启用设备来唤醒计算机。
*WakeOnMagicPacket
一个 值,该值描述在设备收到 幻数据包时是否应启用设备来唤醒计算机。 (幻数据包 是一个数据包,其中包含接收网络适配器的以太网地址的 16 个连续副本)
*PMARPOffload
一个 值,该值描述系统进入睡眠状态时,是否应启用设备以卸载地址解析协议 (ARP) 。
*PMNSOffload
一个 值,该值描述系统进入睡眠状态时,是否应启用设备以卸载 NS) (邻居请求。
*PMWiFiRekeyOffload
一个 值,该值描述在计算机进入睡眠状态时,是否应启用设备以卸载组时态密钥 (GTK) 重新生成密钥以实现无线 LAN 唤醒 (WOL) 。
*EEE
一个值,该值描述设备是否应启用 IEEE 802.3az Energy-Efficient以太网。
本主题末尾的表中的列描述了枚举关键字的以下属性:
SubkeyName
必须在 INF 文件中指定且显示在注册表中的关键字 (keyword) 的名称。
ParamDesc
与 SubkeyName 关联的显示文本。
值
与列表中的每个选项关联的枚举整数值。 此值存储在 NDI\params\SubkeyName\Value 中。
EnumDesc
与菜单中显示的每个值关联的显示文本。
下表描述了 NDIS 和 NetAdapterCx 驱动程序使用的电源管理关键字的可能 INF 条目。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*WakeOnPattern | 唤醒模式匹配 | 0 | 已禁用 |
1 (默认) | Enabled | ||
*WakeOnMagicPacket | 在魔术数据包上唤醒 | 0 | 已禁用 |
1 (默认) | Enabled | ||
*PMARPOffload | ARP 卸载 | 0 | 已禁用 |
1 (默认) | Enabled | ||
*PMNSOffload | NS 卸载 | 0 | 已禁用 |
1 (默认) | Enabled | ||
*PMWiFiRekeyOffload | WiFi 重新生成密钥卸载 | 0 | 已禁用 |
1 (默认) | Enabled | ||
*EEE | Energy-Efficient以太网 | 0 | 已禁用 |
1 (默认) | Enabled |
NetAdapterCx 专属的电源管理关键字
以下电源管理关键字仅供 NetAdapterCx 客户端驱动程序使用。
除了按照用户控制设备空闲和唤醒行为中所述的用户控制设备空闲和唤醒行为的标准 WDF 过程外,NetAdapterCx 还定义了特定于网络设备的标准化 INF 关键字 (keyword) ,以允许更多控制。
*IdleRestriction
如果网络设备同时具有空闲电源关闭和数据包唤醒筛选器功能,则此设置允许用户决定设备空闲关闭时间。
*IdleRestriction 是枚举标准化 INF 关键字 (keyword) ,具有以下属性:
下表描述了 *IdleRestriction 关键字 (keyword) 可能的 INF 条目。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*IdleRestriction | 空闲关机限制 | 0(默认值) | 无限制 |
1 | 仅在用户不存在时处于空闲状态 |
NDIS 专属的电源管理关键字
以下电源管理关键字仅适用于传统的 NDIS 微型端口驱动程序。 NetAdapterCx 客户端驱动程序不得使用它们。
*ModernStandbyWoLMagicPacket
一个 值,该值描述当设备收到 幻宝 并且系统处于 S0ix 电源状态时,是否应启用设备来唤醒计算机。 当系统处于 S4 电源状态时,这不适用。
注意
*ModernStandbyWoLMagicPacket 在 NDIS 6.60 及更高版本或Windows 10版本 1607 及更高版本中受支持。
*DeviceSleepOnDisconnect
一个 值,该值描述是否应启用设备以将设备置于低功耗状态 (睡眠状态,) 媒体断开连接时, (唤醒状态) 再次连接媒体时返回全功率状态。
下表描述了 NDIS 微型端口驱动程序使用的电源管理关键字的可能 INF 条目。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*ModernStandbyWoLMagicPacket | 当系统处于 S0ix 电源状态时,神奇数据包唤醒 | 0(默认值) | 已禁用 |
1 | 已启用 | ||
*DeviceSleepOnDisconnect | 断开连接时设备睡眠 | 0 | 已禁用 |
1 (默认) | Enabled |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈