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

  • Статья

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

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

NDIS_NIC_SWITCH_INFO_REVISION_1

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

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

Flags

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

Примечание Для NDIS 6.30 флаги конфигурации для коммутатора не определены. Элемент Flags должен иметь нулевое значение.
 

SwitchType

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

SwitchId

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

Примечание Начиная с Windows Server 2012 интерфейс sr-IOV (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 по умолчанию в дополнение к неотложенным VPort, созданным с помощью запросов на набор OID OID_NIC_SWITCH_CREATE_VPORT.
 

NumQueuePairsForDefaultVPort

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

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

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

NumQueuePairsForNonDefaultVPorts

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

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

NumActiveDefaultVPortMacAddresses

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

NumActiveNonDefaultVPortMacAddresses

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

NumActiveDefaultVPortVlanIds

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

NumActiveNonDefaultVPortVlanIds

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

Комментарии

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

Примечание Начиная с версии 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 (включая Ndis.h)

См. также раздел

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT