用于电源管理的标准化 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:描述计算机进入睡眠状态时,是否应启用设备卸载用于无线局域网唤醒 (WOL) 的组时序密钥 (GTK) 重新密钥的值。
*EEE:一个值,描述设备是否应启用 IEEE 802.3az 节能以太网。
本文末尾的表中的列描述了枚举关键字的以下属性:
SubkeyName:必须在 INF 文件中指定且出现在注册表中的关键字的名称。
ParamDesc:与 SubkeyName 关联的显示文本。
值:与列表中的每个选项关联的枚举整数值。 此值存储在 NDI\params\SubkeyName\Value中。
EnumDesc:与菜单中显示的每个值关联的显示文本。
下表描述了 NDIS 和 NetAdapterCx 驱动程序使用的电源管理关键字的可能 INF 条目。
子键名称 | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*WakeOnPattern | 唤醒模式匹配 | 0 | 已禁用 |
1 (默认值) | Enabled | ||
*WakeOnMagicPacket | 在幻数据包上唤醒 | 0 | 已禁用 |
1 (默认值) | Enabled | ||
*PMARPOffload | ARP 卸载 | 0 | 已禁用 |
1 (默认值) | Enabled | ||
*PMNSOffload | NS 卸载 | 0 | 已禁用 |
1 (默认值) | Enabled | ||
*PMWiFiRekeyOffload | Wi-Fi 重新生成密钥卸载 | 0 | 已禁用 |
1 (默认值) | Enabled | ||
*EEE | 节能以太网 | 0 | 已禁用 |
1 (默认值) | Enabled |
专用于 NetAdapterCx 的电源管理关键字
以下电源管理关键字仅适用于 NetAdapterCx 客户端驱动程序。
除了提供用户对设备空闲和唤醒行为的控制的标准 WDF 过程,如 用户控制设备空闲和唤醒行为中所述,NetAdapterCx 还定义了一个特定于网络设备的标准化 INF 关键字,以允许更多控制。
*IdleRestriction:如果网络设备同时具有空闲端点和数据包过滤器唤醒功能,则此设置允许用户决定设备空闲断电的时间。
*IdleRestriction 是一个枚举标准化的 INF 关键字。 下表描述了 *IdleRestriction 关键字的可能 INF 条目。
子键名称 | 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 | Enabled | ||
*DeviceSleepOnDisconnect | 连接断开时设备进入睡眠模式 | 0 | 已禁用 |
1 (默认值) | Enabled |