电源管理的标准化 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 条目。
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 | 节能以太网 | 0 | 已禁用 |
1(默认值) | Enabled |
专用于 NetAdapterCx 的电源管理关键字
以下电源管理关键字仅适用于 NetAdapterCx 客户端驱动程序。
除了设备空闲和唤醒行为的用户控制中描述的让用户控制设备空间和唤醒行为的标准 WDF 进程之外,NetAdapterCx 还定义了特定于标准化 INF 的网络设备关键字,以允许更多控制。
*IdleRestriction
如果网络设备同时具有空闲端点和数据包过滤器唤醒功能,则此设置允许用户决定设备空闲断电的时间。
*IdleRestriction 是一个枚举标准化 INF 关键字,具有以下属性:
下表描述了 *IdleRestriction 关键字可能的 INF 条目。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*IdleRestriction | 怠速断电限制 | 0(默认值) | 无限制 |
1 | 仅当用户不存在时处于空闲状态 |
专用于 NDIS 的电源管理关键字
以下电源管理关键字仅适用于传统的 NDIS 微型端口驱动程序。 NetAdapterCx 客户端驱动程序不得使用它们。
*ModernStandbyWoLMagicPacket
描述当设备收到 幻数据包且系统处于 S0ix 电源状态时是否应启用设备以唤醒计算机。 当系统处于 S4 电源状态时,这不适用。
注意
*NDIS 6.60 及更高版本或 Windows 10 版本 1607 及更高版本支持 *ModernStandbyWoLMagicPacket。
*DeviceSleepOnDisconnect
描述当媒体断开连接时设备是否应启用,以便在媒体再次连接时将设备置于低功率状态(睡眠状态),并返回到全功率状态(唤醒状态)的值。
下表描述了 NDIS 和微型端口驱动程序使用的电源管理关键字可能的 INF 条目。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*ModernStandbyWoLMagicPacket | 当系统处于 S0ix 电源状态时唤醒幻数据包 | 0(默认值) | 已禁用 |
1 | 已启用 | ||
*DeviceSleepOnDisconnect | 断开连接时的设备睡眠 | 0 | 已禁用 |
1(默认值) | Enabled |