NDIS 选择性挂起的标准化 INF 关键字

  • 项目

注意

选择性挂起相关关键字仅用于传统的 NDIS 微型端口驱动程序使用。 在 NetAdapterCx) 的网络适配器 WDF 类扩展 ( 中已弃用它们，并且不得由其客户端驱动程序使用。

定义以下标准化 INF 关键字是为了在微型端口驱动程序上启用、禁用和配置 NDIS 选择性挂起的参数：

*SelectiveSuspend INF 关键字

*SSIdleTimeout INF 关键字

*SSIdleTimeoutScreenOff INF 关键字

有关标准化 INF 关键字的详细信息，请参阅 网络设备的标准化 INF 关键字。

*SelectiveSuspend INF 关键字

支持 NDIS 选择性挂起的微型端口驱动程序的 INF 文件必须指定 *SelectiveSuspend 标准化 INF 关键字 (keyword) 。 安装驱动程序后，管理员可以更新网络适配器的“高级”属性页中的*SelectiveSuspend 关键字 (keyword) 值。 有关高级属性的详细信息，请参阅 指定高级属性页的配置参数。

注意 在适配器的 “高级 ”属性页中进行更改后，微型端口驱动程序会自动重启。

*SelectiveSuspend INF 关键字 (keyword) 是枚举关键字 (keyword) 。 下表描述了 *SelectiveSuspend INF 关键字 (keyword) 可能的 INF 条目。 下表中的列描述了枚举关键字 (keyword) 的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字 (keyword) 的名称。 此名称也会显示在网络适配器的 NDI\params\ 键下的注册表中。

ParamDesc
与 SubkeyName 关联的显示文本。

注意 独立硬件供应商 (IHV) 可以为 SubkeyName 定义任何描述性文本。

值
与列表中的每个 SubkeyName 关联的枚举整数值。

EnumDesc
与 “高级 ”属性页中显示的每个值关联的显示文本。

SubkeyName ParamDesc 值 EnumDesc

*SelectiveSuspend

选择性挂起

0

已禁用

1 (默认)

Enabled

微型端口驱动程序必须在注册表中检查 *SelectiveSuspend 关键字 (keyword) 值，然后才能播发对 NDIS 选择性挂起的支持。 如果 *SelectiveSuspend 关键字 (keyword) 的值为零，则微型端口不得播发对任何选择性挂起功能的支持。 有关详细信息，请参阅 报告 NDIS 选择性挂起功能。

*SSIdleTimeout INF 关键字

支持 NDIS 选择性挂起的微型端口驱动程序的 INF 文件应指定可选的 *SSIdleTimeout 标准化 INF 关键字 (keyword) 。 此关键字 (keyword) 指定空闲超时期限（以秒为单位）。 如果 NDIS 在超过 *SSIdleTimeout 值的时间段内未检测到网络适配器上的任何活动，则 NDIS 通过调用微型端口驱动程序的 MiniportIdleNotification 处理程序函数启动选择性挂起操作。

安装驱动程序后，管理员可以更新网络适配器的“高级”属性页中的 *SSIdleTimeout 关键字 (keyword) 值。 有关高级属性的详细信息，请参阅 指定高级属性页的配置参数。

注意 在适配器的高级属性页中进行更改后，微型端口驱动程序会自动重启。

*SSIdleTimeout INF 关键字 (keyword) 是一个数字 (Int) 关键字 (keyword) 。 下表描述了 *SSIdleTimeout INF 关键字 (keyword) 可能的 INF 条目。 表中的列描述了 Int 关键字 (keyword) 的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字 (keyword) 的名称。 此名称也会显示在网络适配器的 NDI\params\ 键下的注册表中。

ParamDesc
与 SubkeyName 关联的显示文本。

注意 独立硬件供应商 (IHV) 可以为 SubkeyName 定义任何描述性文本。

默认值
整数的默认值。

最小值
整数允许的最小值。

最大值
整数允许的最大值。

SubkeyName ParamDesc 默认值 最小值 最大值

*SSIdleTimeout

选择性挂起空闲超时（以秒为单位）

5

1

60

注意NDIS 为驱动程序支持 NDIS 选择性挂起的每个网络适配器实例读取 *SSIdleTimeout 标准化 INF 关键字 (keyword) 的值。 微型端口驱动程序不应读取此关键字 (keyword) 。

NDIS 通过使用精确到 *SSIdleTimeout 值的 30% 范围内的计时器来度量空闲超时。 例如，如果 *SSIdleTimeout 值为 10，则在 NDIS 首次检测到适配器空闲后，适配器会在 10 到 13 秒之间挂起。

*SSIdleTimeoutScreenOff INF 关键字

支持 NDIS 选择性挂起的微型端口驱动程序的 INF 文件应指定可选的 *SSIdleTimeoutScreenOff 标准化 INF 关键字 (keyword) 。 此关键字 (keyword) 以秒为单位指定空闲超时期限，仅在屏幕关闭时适用。 如果 NDIS 在屏幕关闭后在超过 *SSIdleTimeoutScreenOff 值的时间段内未检测到网络适配器上的任何活动，则 NDIS 通过调用微型端口驱动程序的 MiniportIdleNotification 处理程序函数启动选择性挂起操作。

安装驱动程序后，管理员可以更新网络适配器的“高级”属性页中的 *SSIdleTimeoutScreenOff 关键字 (keyword) 值。 有关高级属性的详细信息，请参阅 指定高级属性页的配置参数。

注意 在适配器的高级属性页中进行更改后，微型端口驱动程序会自动重启。

*SSIdleTimeoutScreenOff INF 关键字 (keyword) 是一个数字 (Int) 关键字 (keyword) 。 下表描述了 *SSIdleTimeoutScreenOff INF 关键字 (keyword) 可能的 INF 条目。 表中的列描述了 Int 关键字 (keyword) 的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字 (keyword) 的名称。 此名称也会显示在网络适配器的 NDI\params\ 键下的注册表中。

ParamDesc
与 SubkeyName 关联的显示文本。

注意 独立硬件供应商 (IHV) 可以为 SubkeyName 定义任何描述性文本。

默认值
整数的默认值。

最小值
整数允许的最小值。

最大值
整数允许的最大值。

SubkeyName ParamDesc 默认值 最小值 最大值

*SSIdleTimeoutScreenOff

选择性挂起空闲超时（以秒为单位）

3

1

60

注意NDIS 读取驱动程序支持 NDIS 选择性挂起的每个网络适配器实例的 *SSIdleTimeoutScreenOff 标准化 INF 关键字 (keyword) 的值。 微型端口驱动程序不应读取此关键字 (keyword) 。

注意 最大值仅用于测试目的。 如果值大于 5，HLK 认证测试将显式检查并失败。

NDIS 通过使用精确到 *SSIdleTimeoutScreenOff 值 30% 以内的计时器来测量空闲超时。 例如，如果 *SSIdleTimeoutScreenOff 值为 5，则适配器在 NDIS 首次检测到适配器空闲后 5 到 6.5 秒之间挂起。