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

Статья
08/07/2023

Структура NDIS_NIC_SWITCH_VPORT_INFO указывает конфигурацию виртуального порта (VPort) на коммутаторе сетевого адаптера.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Члены

Header

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

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

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

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

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

VPortId

Значение NDIS_NIC_SWITCH_VPORT_ID, однозначно определяющее виртуальный порт (VPort) сетевого адаптера.

Значение NDIS_DEFAULT_VPORT_ID указывает VPort по умолчанию на коммутаторе. VPort по умолчанию всегда подключен к физической функции (PF) PCI Express (PCIe) сетевого адаптера.

Примечание Неотвратимый VPort с указанным значением VPortId должен быть ранее создан с помощью запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для NDIS.

SwitchId

Значение NDIS_NIC_SWITCH_ID, однозначно определяющее коммутатор сетевого адаптера, созданный в сетевом адаптере. Порт VPort, определенный с помощью элемента VPortId , создается на коммутаторе, указанном в элементе SwitchId .

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

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

VPortName

Значение NDIS_VPORT_NAME, указывающее имя VPort, созданного на коммутаторе сетевого адаптера. Этот элемент содержит понятное описание VPort.

AttachedFunctionId

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

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

NumQueuePairs

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

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

InterruptModeration

Значение NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION , указывающее параметр модерации прерываний для VPort.

VPortState

Значение NDIS_NIC_SWITCH_VPORT_STATE , указывающее состояние VPort.

ProcessorAffinity

Значение GROUP_AFFINITY , указывающее номер группы и точечный рисунок ЦП, с которыми может быть связан этот VPort.

Этот элемент действителен только для виртуальных портов, подключенных к PF. Это поле недопустимо для неотложных виртуальных портов, подключенных к VF.

LookaheadSize

Этот элемент зарезервирован для использования в будущем. Этот элемент должен иметь нулевое значение.

NumFilters

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

Примечание Начиная с версии NDIS 6.30 драйвер мини-порта должен поддерживать счетчик для текущего количества фильтров приема, установленных на сетевом адаптере. Драйвер должен увеличивать счетчик каждый раз, когда фильтр получения устанавливается с помощью запроса на набор OID OID_RECEIVE_FILTER_SET_FILTER. Драйвер также должен уменьшать счетчик каждый раз, когда фильтр получения очищается с помощью запроса на набор OID OID_RECEIVE_FILTER_CLEAR_FILTER.

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

Одна или несколько NDIS_NIC_SWITCH_VPORT_INFO структур возвращаются через структуру NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

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

Требования

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

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_VPORT_PARAMETERS

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