структура NDIS_NIC_SWITCH_VPORT_INFO_ARRAY (ntddndis.h)
Структура 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. При этом перечисляются все виртуальные порты, созданные на коммутаторе.
SwitchId
Значение NDIS_NIC_SWITCH_ID, указывающее идентификатор коммутатора. Идентификатор коммутатора — это целое число от нуля до числа коммутаторов, поддерживаемых сетевым адаптером. Значение NDIS_DEFAULT_SWITCH_ID указывает на коммутатор сетевого адаптера по умолчанию.
Элемент SwitchId действителен, только если NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH указан в элементе Flags .
AttachedFunctionId
Значение NDIS_SRIOV_FUNCTION_ID, указывающее идентификатор PF или VF сетевого адаптера.
FirstElementOffset
Значение ULONG, указывающее смещение (в байтах) к первому элементу в массиве элементов, следующих за этой структурой. Смещение измеряется от начала структуры NDIS_NIC_SWITCH_VPORT_INFO_ARRAY до начала первого элемента. Каждый элемент в массиве является NDIS_NIC_SWITCH_VPORT_INFO структурой.
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) |
См. также раздел