NDIS 选择性挂起的标准化 INF 关键字
注意
选择性挂起相关关键字仅用于传统的 NDIS 微型端口驱动程序使用。 在 NetAdapterCx) 的网络适配器 WDF 类扩展 ( 中已弃用它们，并且不得由其客户端驱动程序使用。
定义以下标准化 INF 关键字是为了在微型端口驱动程序上启用、禁用和配置 NDIS 选择性挂起的参数：
*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 秒之间挂起。