Стандартизированные ключевые слова INF для выборочной приостановки NDIS
Примечание
Ключевые слова, связанные с выборочной приостановкой, используются только для традиционного драйвера минипорта NDIS. Они являются устаревшими в расширении класса WDF сетевого адаптера (NetAdapterCx) и не должны использоваться клиентскими драйверами.
Для включения, отключения и настройки параметров выборочной приостановки NDIS в драйвере мини-порта определены следующие стандартизированные ключевые слова INF:
*SelectiveSuspend Ключевое слово INF
*SSIdleTimeout Ключевое слово INF
*SSIdleTimeoutScreenOff Ключевое слово INF
Дополнительные сведения о стандартизированных ключевых словах INF см. в разделе Стандартизированные ключевые слова INF для сетевых устройств.
*Ключевое слово SelectiveSuspend INF
INF-файл для драйвера мини-порта, поддерживающего выборочную приостановку NDIS, должен указывать стандартизованный INF-ключевое слово *SelectiveSuspend. После установки драйвера администраторы могут обновить значение ключевое слово *SelectiveSuspend на странице свойств Дополнительно для сетевого адаптера. Дополнительные сведения о дополнительных свойствах см. в разделе Указание параметров конфигурации для страницы "Дополнительные свойства".
Примечание Драйвер мини-порта автоматически перезапускается после внесения изменений на странице свойств Дополнительно для адаптера.
Ключевое слово *SelectiveSuspend INF является ключевое слово перечисления. В следующей таблице описаны возможные записи INF для *SelectiveSuspend INF-ключевое слово. Столбцы в этой таблице описывают следующие атрибуты для ключевое слово перечисления:
SubkeyName
Имя ключевое слово, которое необходимо указать в INF-файле. Это имя также отображается в реестре в разделе NDI\params\ для сетевого адаптера.
ParamDesc
Отображаемый текст, связанный с SubkeyName.
Примечание Независимый поставщик оборудования (IHV) может определить любой описательный текст для subkeyName.
Значение
Целочисленное значение перечисления, связанное с каждым subkeyName в списке.
EnumDesc
Отображаемый текст, связанный с каждым значением, отображаемым на странице свойств Дополнительно .
| SubkeyName | ParamDesc | Значение | EnumDesc |
|---|---|---|---|
*SelectiveSuspend |
Выборочная приостановка |
0 |
Выключено |
1 (по умолчанию) |
Активировано |
Драйвер мини-порта должен проверка значение ключевое слово *SelectiveSuspend в реестре, прежде чем объявить о поддержке выборочной приостановки NDIS. Если ключевое слово *SelectiveSuspend имеет нулевое значение, мини-порт не должен объявлять поддержку каких-либо возможностей выборочной приостановки. Дополнительные сведения см. в статье Отчеты о возможностях выборочной приостановки NDIS.
*Ключевое слово INF SSIdleTimeout
В INF-файле для драйвера мини-порта, поддерживающего выборочную приостановку NDIS, должен быть указан необязательный стандартизованный INF-ключевое слово *SSIdleTimeout. В этом ключевое слово указывается период времени ожидания простоя в единицах секунд. Если NDIS не обнаруживает никаких действий на сетевом адаптере в течение периода, превышающего значение *SSIdleTimeout , NDIS запускает выборочную операцию приостановки, вызвав функцию обработчика MiniportIdleNotification драйвера miniport .
После установки драйвера администраторы могут обновить значение *SSIdleTimeout ключевое слово на странице свойств Дополнительно для сетевого адаптера. Дополнительные сведения о дополнительных свойствах см. в разделе Указание параметров конфигурации для страницы "Дополнительные свойства".
Примечание Драйвер мини-порта автоматически перезапускается после внесения изменений на странице дополнительных свойств адаптера.
Inf-ключевое слово *SSIdleTimeout является числовым (Int) ключевое слово. В следующей таблице описаны возможные записи INF для ключевое слово *SSIdleTimeout INF. Столбцы в таблице описывают следующие атрибуты для ключевое слово Int:
SubkeyName
Имя ключевое слово, которое необходимо указать в INF-файле. Это имя также отображается в реестре в разделе NDI\params\ для сетевого адаптера.
ParamDesc
Отображаемый текст, связанный с SubkeyName.
Примечание Независимый поставщик оборудования (IHV) может определить любой описательный текст для subkeyName.
Значение по умолчанию
Значение по умолчанию для целого числа.
Минимальное значение
Минимальное значение, допустимое для целого числа.
Максимальное значение
Максимальное значение, допустимое для целого числа.
| SubkeyName | ParamDesc | Значение по умолчанию | Минимальное значение | Максимальное значение |
|---|---|---|---|---|
*SSIdleTimeout |
Выборочная приостановка времени ожидания простоя в единицах секунд |
5 |
1 |
60 |
Примечание NDIS считывает значение стандартизованного INF-ключевое слово *SSIdleTimeout для каждого экземпляра сетевого адаптера, драйвер которого поддерживает выборочную приостановку NDIS. Драйверы мини-порта не должны читать эту ключевое слово.
NDIS измеряет время ожидания простоя с помощью таймеров, которые точно равны 30 процентам от значения *SSIdleTimeout . Например, если значение *SSIdleTimeout равно 10, адаптер приостанавливается между 10 и 13 секундами после того, как NDIS впервые обнаружит, что адаптер простаивает.
*Ключевое слово SSIdleTimeoutScreenOff INF
INF-файл для драйвера мини-порта, поддерживающего выборочную приостановку NDIS, должен указывать необязательное стандартное INF-ключевое слово *SSIdleTimeoutScreenOff. Это ключевое слово указывает время ожидания простоя в единицах секунд и применяется только в том случае, если экран выключен. Если NDIS не обнаруживает никаких действий на сетевом адаптере в течение периода, превышающего значение *SSIdleTimeoutScreenOff после выключения экрана, NDIS запускает выборочную операцию приостановки, вызывая функцию обработчика MiniportIdleNotification драйвера miniportIdleNotification .
После установки драйвера администраторы могут обновить значение *SSIdleTimeoutScreenOff ключевое слово на странице свойств Дополнительно для сетевого адаптера. Дополнительные сведения о дополнительных свойствах см. в разделе Указание параметров конфигурации для страницы "Дополнительные свойства".
Примечание Драйвер мини-порта автоматически перезапускается после внесения изменений на странице дополнительных свойств адаптера.
*SSIdleTimeoutScreenOff INF ключевое слово является числовым (Int) ключевое слово. В следующей таблице описаны возможные записи INF для ключевое слово *SSIdleTimeoutScreenOff INF. Столбцы в таблице описывают следующие атрибуты для ключевое слово Int:
SubkeyName
Имя ключевое слово, которое необходимо указать в INF-файле. Это имя также отображается в реестре в разделе NDI\params\ для сетевого адаптера.
ParamDesc
Отображаемый текст, связанный с SubkeyName.
Примечание Независимый поставщик оборудования (IHV) может определить любой описательный текст для subkeyName.
Значение по умолчанию
Значение по умолчанию для целого числа.
Минимальное значение
Минимальное значение, допустимое для целого числа.
Максимальное значение
Максимальное значение, допустимое для целого числа.
| Имя подраздела | ParamDesc | Значение по умолчанию | Минимальное значение | Максимальное значение |
|---|---|---|---|---|
*SSIdleTimeoutScreenOff |
Время ожидания выборочной приостановки простоя в секундах |
3 |
1 |
60 |
Примечание NDIS считывает значение стандартизованного INF-ключевое слово *SSIdleTimeoutScreenOff для каждого экземпляра сетевого адаптера, драйвер которого поддерживает выборочную приостановку NDIS. Драйверы минипорта не должны читать эту ключевое слово.
Примечание Максимальное значение — только для целей тестирования. Тест сертификации HLK явно проверка и завершится ошибкой, если значение больше 5.
NDIS измеряет время ожидания простоя с помощью таймеров, которые точно равны 30 процентам от значения *SSIdleTimeoutScreenOff . Например, если значение *SSIdleTimeoutScreenOff равно 5, адаптер приостанавливается между 5 и 6,5 секундами после того, как NDIS впервые обнаружит, что адаптер неактивен.