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

Статья
02/07/2025

Структура 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.

Драйвер минипорта должен задать для элемента типазаголовка значение 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.

Примечание Перед присоединением виртуальногоF к дочерней секции 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 (include Ndis.h)