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

Статья
02/27/2024

Структура NDIS_NIC_SWITCH_VPORT_INFO_ARRAY задает массив. Каждый элемент в массиве задает атрибуты виртуального порта (VPort), созданного на коммутаторе сетевого адаптера.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Члены

Header

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

NDIS задает для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , NDIS устанавливает для элемента Revisionзаголовка следующее значение:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

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

Flags

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Этот флаг указывает на перечисление виртуальных портов, подключенных к определенной функции PCI Express (PCIe). Функция указывается в элементе AttachedFunctionId . Этот флаг можно использовать для перечисления виртуальных портов, подключенных к физической функции PCIe (PF) или указанной виртуальной функции PCIe (VF).

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Этот флаг указывает на перечисление виртуальных портов, созданных на определенном коммутаторе, заданном параметром SwitchId. При этом перечисляются все виртуальные порты, созданные на коммутаторе.

Примечание Эти флаги являются взаимоисключающими. В элементе Flags можно задать только один флаг.

SwitchId

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

Элемент SwitchId действителен, только если NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH указан в элементе Flags .

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

AttachedFunctionId

Значение NDIS_SRIOV_FUNCTION_ID, указывающее идентификатор PF или VF сетевого адаптера.

Примечание Если это значение равно NDIS_PF_FUNCTION_ID, VPort присоединяется к PF.

Элемент AttachedFunctionId действителен только в том случае, если NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION указан в элементе Flags .

FirstElementOffset

Значение ULONG, указывающее смещение (в байтах) к первому элементу в массиве элементов, следующих за этой структурой. Смещение измеряется от начала структуры NDIS_NIC_SWITCH_VPORT_INFO_ARRAY до начала первого элемента. Каждый элемент в массиве является NDIS_NIC_SWITCH_VPORT_INFO структурой.

Примечание Если для NumElements задано нулевое значение, этот элемент игнорируется.

NumElements

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

ElementSize

Значение ULONG, указывающее размер (в байтах) каждого элемента, следующего за NDIS_NIC_SWITCH_VPORT_INFO_ARRAY структурой.

NDIS возвращает структуру NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , когда NDIS обрабатывает запрос метода OID OID_NIC_SWITCH_ENUM_VPORTS. Каждый элемент в массиве, который следует за структурой NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , является
NDIS_NIC_SWITCH_VPORT_INFO структура.

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

Требования

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

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

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

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