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

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

*SelectiveSuspend INF 关键字

*SSIdleTimeout INF 关键字

*SSIdleTimeoutScreenOff INF 关键字

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

*SelectiveSuspend INF 关键字

The INF file for the miniport driver that supports NDIS selective suspend must specify the *SelectiveSuspend standardized INF keyword. After the driver is installed, administrators can update the *SelectiveSuspend keyword value in the Advanced property page for the network adapter. 有关高级属性的详细信息，请参阅 “指定高级属性”页的配置参数。

Note The miniport driver is automatically restarted after a change is made in the Advanced property page for the adapter.

The *SelectiveSuspend INF keyword is an enumeration keyword. The following table describes the possible INF entries for the *SelectiveSuspend INF keyword. 下表中的列描述了枚举关键字的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字的名称。 This name also appears in the registry under the NDI\params\ key for the network adapter.

ParamDesc
与 SubkeyName 关联的显示文本。

Note The independent hardware vendor (IHV) can define any descriptive text for the SubkeyName.

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

EnumDesc
The display text that is associated with each value that appears in the Advanced property page.

The miniport driver must check the *SelectiveSuspend keyword value in the registry before it advertises its support for NDIS selective suspend. If the *SelectiveSuspend keyword has a value of zero, the miniport must not advertise support for any selective suspend capabilities. 有关详细信息，请参阅 报告 NDIS 选择性挂起功能。

*SSIdleTimeout INF 关键字

The INF file for the miniport driver that supports NDIS selective suspend should specify the optional *SSIdleTimeout standardized INF keyword. 此关键字以秒为单位指定空闲超时期限。 If NDIS does not detect any activity on the network adapter for a period that exceeds the *SSIdleTimeout value, NDIS starts a selective suspend operation by calling the miniport driver's MiniportIdleNotification handler function.

After the driver is installed, administrators can update the *SSIdleTimeout keyword value in the Advanced property page for the network adapter. 有关高级属性的详细信息，请参阅 “指定高级属性”页的配置参数。

Note The miniport driver is automatically restarted after a change is made in the advanced property page for the adapter.

The *SSIdleTimeout INF keyword is a numeric (Int) keyword. The following table describes the possible INF entries for the *SSIdleTimeout INF keyword. The columns in the table describe the following attributes for an Int keyword:

SubkeyName
必须在 INF 文件中指定的关键字的名称。 This name also appears in the registry under the NDI\params\ key for the network adapter.

ParamDesc
与 SubkeyName 关联的显示文本。

Note The independent hardware vendor (IHV) can define any descriptive text for the SubkeyName.

默认值
整数的默认值。

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

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

Note NDIS reads the value of the *SSIdleTimeout standardized INF keyword for every instance of the network adapter whose driver supports NDIS selective suspend. 微型端口驱动程序不应阅读此关键字。

NDIS measures the idle time-out by using timers that are precise to within 30 percent of the *SSIdleTimeout value. For example, if the *SSIdleTimeout value is 10, the adapter is suspended between 10 to 13 seconds after NDIS first detects the adapter is idle.

*SSIdleTimeoutScreenOff INF 关键字

The INF file for the miniport driver that supports NDIS selective suspend should specify the optional *SSIdleTimeoutScreenOff standardized INF keyword. 此关键字指定空闲超时期限（以秒为单位）并且仅在屏幕关闭时适用。 If NDIS does not detect any activity on the network adapter for a period that exceeds the *SSIdleTimeoutScreenOff value after the screen is off, NDIS starts a selective suspend operation by calling the miniport driver's MiniportIdleNotification handler function.

After the driver is installed, administrators can update the *SSIdleTimeoutScreenOff keyword value in the Advanced property page for the network adapter. 有关高级属性的详细信息，请参阅 “指定高级属性”页的配置参数。

Note The miniport driver is automatically restarted after a change is made in the advanced property page for the adapter.

The *SSIdleTimeoutScreenOff INF keyword is a numeric (Int) keyword. The following table describes the possible INF entries for the *SSIdleTimeoutScreenOff INF keyword. The columns in the table describe the following attributes for an Int keyword:

SubkeyName
必须在 INF 文件中指定的关键字的名称。 This name also appears in the registry under the NDI\params\ key for the network adapter.

ParamDesc
与 SubkeyName 关联的显示文本。

Note The independent hardware vendor (IHV) can define any descriptive text for the SubkeyName.

默认值
整数的默认值。

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

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

Note NDIS reads the value of the *SSIdleTimeoutScreenOff standardized INF keyword for every instance of the network adapter whose driver supports NDIS selective suspend. 微型端口驱动程序不应阅读此关键字。

Note The maximum value is only for testing purposes. 如果值大于 5，HLK 认证测试将显式检查并失败。

NDIS measures the idle time-out by using timers that are precise to within 30 percent of the *SSIdleTimeoutScreenOff value. For example, if the *SSIdleTimeoutScreenOff value is 5, the adapter is suspended between 5 to 6.5 seconds after NDIS first detects the adapter is idle.