Стандартные ключевые слова INF для SR-IOV

В этом разделе описаны стандартные ключевые слова INF для интерфейса виртуализации одно корневых операций ввода-вывода (SR-IOV). Эти ключевые слова применяются к INF-файлу для минипорт-драйвера физической функции (PF) PCI Express (PCIe) сетевого адаптера SR-IOV.

Ключевые слова INF SR-IOV описаны в следующих разделах:

Стандартные ключевые слова INF для включения или отключения SR-IOV возможностей

стандартные ключевые слова INF для настройки переключателя сетевого адаптера по умолчанию

Стандартные ключевые слова INF для включения или отключения поддержки SR-IOV

Стандартные ключевые слова INF определяются для включения или отключения поддержки функций SR-IOV сетевого адаптера.

*SRIOV
Значение, описывающее, включена ли или отключена функция SR-IOV устройства.

After the driver is installed, administrators can update the *SRIOV 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.

*SriovPreferred
Значение, определяющее, следует ли включить функции SR-IOV вместо очереди виртуальных машин (VMQ) или функции масштабирования на стороне получения (RSS).

This is a hidden keyword value that must not be specified in the INF file and is not displayed in Advanced property page for the network adapter.

Дополнительные сведения об интерпретации ключевых слов SR-IOV, VMQ и RSS см. в разделе Обработка стандартизированных INF-ключевых слов SR-IOV, VMQ и RSS.

SR-IOV стандартизированные ключевые слова INF являются ключевыми словами перечисления и описаны в следующей таблице. Столбцы в этой таблице описывают следующие атрибуты ключевого слова перечисления:

SubkeyName
Имя ключевого слова, которое необходимо указать в INF-файле. This name also appears in the registry under the NDI\params\ key for the network adapter.

ParamDesc
The display text that is associated with the SubkeyName keyword.

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

Value
The enumeration integer value that is associated with each SubkeyName keyword in the list.

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

SubkeyName ParamDesc Value EnumDesc
*SRIOV SR-IOV 0 Disabled
1 (Default) Enabled
*SriovPreferred Записи ParamDesc и EnumDesc для этого подраздела нельзя использовать в INF-файлах или пользовательском интерфейсе. 0 (Default) Report RSS or VMQ capabilities based on the *VmqOrRssPreferrence keyword. Не сообщайте о возможностях SR-IOV. For more information about the *VmqOrRssPreferrence keyword, see Standardized INF Keywords for VMQ.
1 Возможности отчета SR-IOV.

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

Стандартные ключевые слова INF для настройки коммутатора сетевого интерфейса по умолчанию

Начиная с Windows Server 2012 интерфейс SR-IOV поддерживает только один коммутатор сетевого адаптера. Этот коммутатор известен как коммутатор сетевого адаптера по умолчанию и обозначается идентификатором NDIS_DEFAULT_SWITCH_ID.

INF-файл для минипорт-драйвера PF должен указать конфигурацию переключателя сетевой карты по умолчанию на сетевом адаптере SR-IOV. This allows the network installer to copy the default switch configuration information from the INF to the miniport registry configuration under the subkey for the default switch (NDI\params\NicSwitches\0).

These keywords are not displayed in the Advanced property page for the network adapter and cannot be configured by the user. These keywords are specified by using the AddReg directive in the DDInstall section of the INF file. Each keyword is specified by a separate AddReg directive.

В следующей таблице описаны ключевые слова INF для конфигурации коммутатора сетевого адаптера SR-IOV по умолчанию. Столбцы в этой таблице описывают следующие атрибуты для этих ключевых слов:

SubkeyName
Имя ключевого слова, которое необходимо указать в INF-файле. This name also appears in the registry under the NDI\params\NicSwitches\0 key for the network adapter.

Data value
The value that is associated with the SubkeyName keyword.

Data type
Тип значения данных.

SubkeyName Data value Data type Notes
*Flags 0 REG_DWORD Ключевое слово должно быть присвоено этому значению.
*SwitchType 1 REG_DWORD Ключевое слово должно быть присвоено этому значению.
*SwitchId 0 REG_DWORD Ключевое слово должно быть присвоено этому значению.
*SwitchName “Default Switch” REG_SZ Ключевое слово должно быть присвоено этому значению.
*NumVFs (0-n), REG_DWORD n is the maximum number of PCIe Virtual Functions (VFs) that are supported by the SR-IOV network adapter. Note This registry key defines the maximum number of VFs that the network adapter supports. When the miniport driver calls NdisMSetMiniportAttributes, it can advertise less than this value depending on the available hardware resources on the network adapter. Более подробную информацию см. в разделе Определение возможностей сетевых коммутаторов.

The following is an example of AddReg directives for the default NIC switch configuration of an SR-IOV network adapter:

HKR, NicSwitches\0, *SwitchId,   0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”

For more information about the syntax of the AddReg directive, see INF AddReg Directive.

For more information about the default NIC switch, see NIC Switches.

  • Last updated on