Ключевые слова перечисления

NDIS 6.0 и более поздние версии NDIS предоставляют стандартизированные ключевые слова перечисления для драйверов минипорта сетевых устройств. Ключевые слова перечисления связаны со значениями, которые отображаются в меню в виде списка.

В следующем примере показано определение INF-файла для ключевое слово перечисления.

HKR, Ndi\params\<SubkeyName>, ParamDesc, 0, "%<SubkeyName>%"
HKR, Ndi\params\<SubkeyName>, Type, 0, "enum"
HKR, Ndi\params\<SubkeyName>, Default, 0, "3"
HKR, Ndi\params\<SubkeyName>, Optional, 0, "0"
HKR, Ndi\params\<SubkeyName>\enum, "0", 0, "%Disabled%"
HKR, Ndi\params\<SubkeyName>\enum, "1", 0, "%Tx Enabled%"
HKR, Ndi\params\<SubkeyName>\enum, "2", 0, "%Rx Enabled%"
HKR, Ndi\params\<SubkeyName>\enum, "3", 0, "%Rx & Tx Enabled%"

Общие ключевые слова перечисления:

*SpeedDuplex
Параметры скорости и дуплексные параметры, поддерживаемые устройством. В INF-файле устройства должны быть указаны только параметры, поддерживаемые связанным устройством. То есть для устройства Ethernet 10/100, которое поддерживает только полнодуплексный режим, параметры для гигабитных или более высоких скоростей или полудуплексных параметров не должны быть указаны в связанном INF-файле.

Значения скорости, которые еще не определены специально с перечисляемыми значениями от 0 до 10, могут быть заданы как число, которое является значением непосредственно в Мбит/с. Прямые значения должны быть не менее 1000 Мбит/с (1 Гбит/с) и выше. Ниже приведено несколько примеров непосредственного указания скорости.

*FlowControl
Возможность устройства включать или отключать управление потоком в пути отправки или получения.

Примечание Устройства Ethernet сегодня поддерживают управление потоками, а встроенные драйверы Windows 8 для локальной сети по умолчанию поддерживают управление потоками. Когда отладчик ядра подключается к одному из этих адаптеров локальной сети, сетевой адаптер начнет отправлять кадры приостановки потока в сеть. Большинство сетевых коммутаторов будут реагировать, временно отключая сеть для всех остальных компьютеров, подключенных к тому же концентратору. Это распространенный сценарий разработки, и взаимодействие с конечным пользователем нежелательно и трудно диагностировать.

Примечание Значения по умолчанию для клиента и сервера не совпадают; см. таблицу значений по умолчанию ниже.

По этой причине в Windows 8 и более поздних версиях NDIS автоматически отключает управление потоком при включенной отладке на компьютере (например, введите bcdedit /set debug on в командной строке). Если отладка ядра включена и минипорт вызывает NdisReadConfiguration и передает "*FlowControl" для параметра Keyword , NDIS переопределит настроенное значение и возвратит ноль.

Если необходимо включить управление потоком во время отладки, NDIS предоставляет значение реестра AllowFlowControlUnderDebugger , позволяющее сделать это. Значение реестра AllowFlowControlUnderDebugger не позволяет NDIS отключать управление потоком и позволяет сетевым адаптерам сохранять настроенное поведение. Его можно найти в следующем разделе реестра:

HKEY_LOCAL_MACHINE\Системы\CurrentControlSet\Услуги\NDIS\Параметры

Задайте для этого параметра реестра значение 0x00000001.

Если оно не существует, можно создать значение с именем AllowFlowControlUnderDebugger и типом REG_DWORD и задать для него значение 0x00000001.

*PriorityVLANTag
Значение , указывающее, включило ли устройство или отключило возможность вставки тегов 802.1Q для приоритета пакетов и виртуальных локальных сетей (VLAN). Этот ключевое слово не указывает, включен или отключен приоритет пакетов устройства или теги виртуальной локальной сети. Вместо этого он описывает следующее:

• Указывает, вставляет ли устройство теги 802.1Q во время операции отправки
• Доступность сведений о теге 802.1Q в NET_BUFFER_LIST сведений о внеполосном канале (OOB)
• Копирует ли устройство теги 802.1Q в OOB во время операций получения

Драйвер мини-порта должен удалить заголовок 802.1Q из всех получаемых пакетов независимо от параметра *PriorityVLANTag . Если заголовок 802.1Q остается в пакете, другие драйверы не смогут правильно проанализировать пакет.

Если флаг Rx включен в пути получения, драйвер мини-порта должен скопировать удаленный заголовок 802.1Q в OOB.

В противном случае, если флаг Rx отключен, драйвер мини-порта не должен копировать удаленный заголовок 802.1Q в OOB.

Если флаг Tx включен на пути передачи, драйвер мини-порта должен выполнить следующие действия:

• Вставьте заголовок 802.1Q в каждый исходящий пакет и заполните его данными из OOB (если в OOB существуют ненулевые данные).
• Объявление соответствующих macOptions в NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (NDIS_MAC_OPTION_8021P_PRIORITY и NDIS_MAC_OPTION_8021Q_VLAN).

В противном случае, если флаг Tx отключен, то:

• Фильтр мини-порта не должен учитывать сведения 802.1Q в OOB (и, следовательно, не вставлять тег).
• Фильтр мини-порта не должен объявлять соответствующие параметры MacOptions в NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Примечание Если драйвер мини-порта поддерживает качество обслуживания (QoS) NDIS, он также должен считывать значение *QOS ключевое слово. В зависимости от значения *QOS ключевое слово значения *PriorityVLANTag ключевое слово интерпретируются по-разному. Дополнительные сведения см. в разделе Стандартизированные ключевые слова INF для качества обслуживания NDIS.

*InterruptModeration
Значение типа , указывающее, включена или отключена модерация прерываний на устройстве. Алгоритмы модерации прерываний зависят от устройства. Производитель устройства может использовать нестандартизированные ключевые слова для поддержки алгоритмических параметров. Дополнительные сведения об модерации прерываний см. в разделе Модерация прерываний.

*RSS
Значение типа , указывающее, включено или отключено ли на устройстве масштабирование на стороне приема (RSS). Дополнительные сведения о rss см. в разделе Масштабирование на стороне приема.

*HeaderDataSplit
Значение типа , описывающее, включено или отключено разделение данных заголовков и заголовков на устройстве. Дополнительные сведения о разделении заголовков и данных см. в разделе Разделение заголовков и данных.

Следующие ключевые слова связаны со службами разгрузки подключений:

*TCPConnectionOffloadIPv4

*TCPConnectionOffloadIPv6

Дополнительные сведения о ключевых словах разгрузки подключения см. в разделе Использование значений реестра для включения и отключения разгрузки подключения.

Следующие ключевые слова связаны со службами разгрузки задач:

*IPChecksumOffloadIPv4

*TCPChecksumOffloadIPv4

*TCPChecksumOffloadIPv6

*UDPChecksumOffloadIPv4

*UDPChecksumOffloadIPv6

*LsoV1IPv4

*LsoV2IPv4

Примечание Для устройств, поддерживающих разгрузку больших объемов отправки версии 1 (LSOv1) и LSOv2 по протоколу IPv4, в INF-файле и значениях реестра следует использовать только ключевое слово *LsoV2IPv4. Если, например, ключевое слово *LsoV2IPv4 отображается в INF-файле, а ключевое слово *LsoV1IPv4 отображается в реестре (или наоборот), ключевое слово *LsoV2IPv4 всегда имеет приоритет.

*LsoV2IPv6

*IPsecOffloadV1IPv4

*IPsecOffloadV2

*IPsecOffloadV2IPv4

*TCPUDPChecksumOffloadIPv4

*TCPUDPChecksumOffloadIPv6

Дополнительные сведения о ключевых словах разгрузки TCP/IP см. в разделе Использование значений реестра для включения и отключения разгрузки задач.

Столбцы в таблице в конце этого раздела описывают следующие атрибуты для ключевых слов перечисления:

Имя подраздела
Имя ключевое слово, которое необходимо указать в INF-файле и которое отображается в реестре.

ParamDesc
Отображаемый текст, связанный с SubkeyName.

Значение
Целочисленное значение перечисления, связанное с каждым параметром в списке. Это значение хранится в NDI\params\SubkeyName\Value.

EnumDesc
Отображаемый текст, связанный с каждым значением, которое отображается в меню.

Default
Значение по умолчанию для меню.

В следующей таблице перечислены все ключевые слова и описаны значения, которые драйвер должен использовать для предыдущих атрибутов. Дополнительные сведения о ключевое слово можно найти по ключевое слово в документации по WDK.