структура NDIS_NIC_SWITCH_PARAMETERS (ntddndis.h)

Статья
03/01/2024

Структура NDIS_NIC_SWITCH_PARAMETERS указывает параметры конфигурации коммутатора сетевого адаптера на сетевом адаптере.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Члены

Header

Тип, редакция и размер структуры NDIS_NIC_SWITCH_PARAMETERS . Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_NIC_SWITCH_PARAMETERS , драйвер должен задать для члена Редакциизаголовка следующее значение:

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента Размер значение NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1.

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Для этого элемента определены следующие флаги.

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

Этот флаг указывает, что поле, обновленное в структуре NDIS_NIC_SWITCH_PARAMETERS , является элементом SwitchName .

Примечание Этот флаг действителен, только если эта структура используется в запросе набора OID OID_NIC_SWITCH_PARAMETERS.

SwitchType

Значение перечисления NDIS_NIC_SWITCH_TYPE , указывающее тип коммутатора сетевого адаптера.

Примечание Начиная с Windows Server 2012, Windows поддерживает только тип коммутатора NdisNicSwitchTypeExternal. Внешний коммутатор указывает, что порты, подключенные к этому типу коммутатора, могут получить доступ к внешней сети через физический порт сетевого адаптера. Виртуальный порт по умолчанию (VPort) на внешнем коммутаторе обеспечивает внешнее сетевое подключение к стеку виртуализации, который выполняется в операционной системе управления родительского раздела Hyper-V.

SwitchId

Значение NDIS_NIC_SWITCH_ID, содержащее идентификатор коммутатора. Идентификатор коммутатора — это целое число от нуля до числа коммутаторов, поддерживаемых сетевым адаптером. Значение NDIS_DEFAULT_SWITCH_ID указывает на коммутатор сетевого адаптера по умолчанию.

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

SwitchFriendlyName

Значение NDIS_NIC_SWITCH_FRIENDLYNAME, содержащее описание параметра.

NumVFs

Значение ULONG, указывающее количество виртуальных функций PCI Express (PCIe), включенных в сетевом адаптере. Виртуальные функции включаются на адаптере, если виртуализация включена с помощью вызова NdisMEnableVirtualization.

Примечание Прежде чем VF можно будет подключить к дочернему разделу Hyper-V, ресурсы должны быть выделены для него с помощью запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

NdisReserved1

Зарезервировано для NDIS.

NdisReserved2

Зарезервировано для NDIS.

NdisReserved3

Зарезервировано для NDIS.

NumQueuePairsForDefaultVPort

Структура NDIS_NIC_SWITCH_PARAMETERS используется в запросах метода OID OID_NIC_SWITCH_CREATE_SWITCH и OID_NIC_SWITCH_PARAMETERS. Эти запросы OID задают или запрашивают параметры конфигурации коммутатора сетевого адаптера.

Дополнительные сведения об интерфейсе SR-IOV см. в статье Обзор виртуализации однокорневого ввода-вывода (SR-IOV).

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)