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

Статья
02/07/2025

Структура NDIS_NIC_SWITCH_INFO указывает сведения о коммутаторе сетевого адаптера на сетевом адаптере.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Члены

Header

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

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

NDIS_NIC_SWITCH_INFO_REVISION_1

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

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

Flags

Значение ULONG, содержащее побитовое ЗНАЧЕНИЕ ИЛИ флагов конфигурации, которые включены в коммутаторе.

Примечание для NDIS 6.30, флаги конфигурации не определены для коммутатора. Для элемента флаги должно быть равно нулю.

SwitchType

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

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), включенных в сетевом адаптере. Включенные виртуальные машины могут находиться в выделенном или нераспределированном состоянии.

NumAllocatedVFs

Значение ULONG, указывающее количество виртуальных машин, выделенных на коммутатор сетевого адаптера, указанного SwitchId. Виртуальные машины выделяются с помощью запросов набора OID OID_NIC_SWITCH_ALLOCATE_VF.

NumVPorts

Значение ULONG, указывающее количество виртуальных портов (VPorts), настроенных на коммутаторе сетевого адаптера, заданном SwitchId.

Это значение ULONG — это сумма следующих значений:

Максимальное количество виртуальных портов, которые можно создать с помощью запросов набора OID OID_NIC_SWITCH_CREATE_VPORT.
VPort по умолчанию, подключенный к физической функции (PF).

NumActiveVPorts

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

Примечание Это значение ULONG включает в себя VPort по умолчанию, а также неdefault VPorts, созданные с помощью запросов набора OID OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

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

Пара очередей состоит из очереди передачи и очереди получения. Драйвер минипорта связывает одну или несколько пар очередей с VPort по умолчанию во время создания коммутатора с помощью запроса метода OID OID_NIC_SWITCH_CREATE_SWITCH.

Примечание Начиная с NDIS 6.30, можно настроить только одну пару очередей, которую можно настроить для VPort по умолчанию.

NumQueuePairsForNonDefaultVPorts

Значение ULONG, указывающее количество пар очередей, выделенных для недефаult VPorts. Неотделимый VPort можно подключить к PF или любому VF сетевого адаптера.

Драйвер минипорта связывает одну или несколько пар очередей с недефельцем VPort через запрос метода OID OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Значение ULONG, указывающее количество фильтров mac-адресов одноадресной рассылки, которые в настоящее время задаются в VPort по умолчанию, подключенном к PF сетевого адаптера.

NumActiveNonDefaultVPortMacAddresses

Значение ULONG, указывающее количество фильтров mac-адресов одноадресной рассылки, которые в настоящее время задаются в недефаult VPorts.

NumActiveDefaultVPortVlanIds

Значение ULONG, указывающее количество фильтров идентификаторов виртуальной локальной сети (VLAN), которые в настоящее время задаются в VPort по умолчанию.

NumActiveNonDefaultVPortVlanIds

Значение ULONG, указывающее количество фильтров идентификаторов виртуальной локальной сети, которые в настоящее время задаются в недефаult VPorts.

Замечания

Структура NDIS_NIC_SWITCH_INFO используется в запросах запросов OID OID_NIC_SWITCH_ENUM_SWITCHES. Этот запрос OID используется для перечисления коммутаторов сетевого адаптера на сетевом адаптере. При выдаче этого запроса OID одна или несколько NDIS_NIC_SWITCH_INFO структур возвращаются в NDIS_NIC_SWITCH_INFO_ARRAY структуре.

Примечание Начиная с NDIS 6.30, возвращается только NDIS_NIC_SWITCH_INFO, описывающая сведения о коммутаторе сетевого адаптера по умолчанию, возвращается через запрос OID OID_NIC_SWITCH_ENUM_SWITCHES.

Структура NDIS_NIC_SWITCH_INFO содержит сведения о коммутаторе сетевого адаптера, который ранее был создан с помощью запроса метода OID OID_NIC_SWITCH_CREATE_SWITCH.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
заголовка	ntddndis.h (include Ndis.h)

См. также

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

Поделиться через