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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
  NDIS_OBJECT_HEADER                         Header;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  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;
  NDIS_NDK_PARAMETERS                        NdkParams;
  NDIS_QOS_SQ_ID                             QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;

Члены

Header

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

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT.

Чтобы указать версию структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS , задайте для элемента Редакциязаголовка одно из следующих значений:

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2

Добавлено поле QosSqId для NDIS 6.50.

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

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1

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

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

Flags

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

NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED

Этот флаг зарезервирован для использования в будущем. Драйверы мини-порта должны игнорировать этот флаг.

NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED

Этот флаг указывает, что элемент Flags был обновлен после создания VPort. Эти флаги можно включить или отключить после создания VPort с помощью запроса набора OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание

Этот флаг действителен только в том случае, если эта структура используется в запросах на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED

Этот флаг указывает, что член VPortName был обновлен после создания VPort. Этот элемент можно обновить с помощью запроса на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание

NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED

Этот флаг указывает, что член InterruptModeration был обновлен после создания VPort. Этот элемент можно обновить с помощью запроса на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

Этот флаг указывает, что член VPortState был обновлен после создания VPort. Этот элемент можно обновить с помощью запроса на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

Этот флаг указывает, что элемент ProcessoryAffinity был обновлен после создания VPort. Сходство процессора VPort можно обновить только в том случае, если VPort подключен к PF на сетевом адаптере. Элемент ProcessoryAffinity можно обновить с помощью запроса набора OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание

NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED

Этот флаг указывает, что элемент NumQueuePairs был обновлен после создания VPort. Если включено несколько очередей виртуальных машин (VMMQ), можно обновить количество очередей для виртуальных портов по умолчанию и не по умолчанию. Элемент NumQueuePairs можно обновить с помощью запроса набора OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Примечание Этот флаг действителен только в том случае, если эта структура используется в запросах на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.

SwitchId

Значение NDIS_NIC_SWITCH_ID, указывающее идентификатор коммутатора, на котором будет создан VPort.

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

Примечание

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

VPortId

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

Значение VPortId находится в диапазоне от нуля до (NumVPorts — 1), где NumVPorts — это число виртуальных портов, настроенных драйвером мини-порта в сетевом адаптере. Драйвер указывает это число в элементе NumVPortsструктуры NDIS_NIC_SWITCH_INFO . Драйвер возвращает эту структуру с помощью запроса OID OID_NIC_SWITCH_ENUM_SWITCHES.

Примечание

Идентификатор VPort NDIS_DEFAULT_VPORT_ID зарезервирован для VPort по умолчанию, подключенного к PF в коммутаторе сетевого адаптера по умолчанию.

VPortName

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

AttachedFunctionId

Значение NDIS_SRIOV_FUNCTION_ID, указывающее идентификатор физической функции (PF) или виртуальной функции (VF), к которым подключен VPort. Значение NDIS_PF_FUNCTION_ID указывает, что VPort присоединен к PF. Если значение является допустимым идентификатором VF, VPort присоединяется к VF.

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.

Примечание

Для VPort, не являющихся стандартными, при создании VPort необходимо указать значение GROUP_AFFINITY, указывающее только один процессор. Виртуальные порты создаются с помощью запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.

Сходство процессора, связанное с неотложным портом VPort, подключенным к PF, можно изменить после создания VPort. Сходство процессора, связанное с VPort по умолчанию, также можно изменить с помощью запроса набора OID OID_NIC_SWITCH_VPORT_PARAMETERS.

LookaheadSize

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

NdkParams

QosSqId

Связывает vPort с очередью планировщика (SQ). Задайте для этого поля допустимый идентификатор SQ, чтобы связать vPort с SQ. Установите для этого поля нулевое значение , если связь SQ отсутствует. Дополнительные сведения о NDIS_QOS_SQ_ID см. в разделе OID_QOS_OFFLOAD_CREATE_SQ.

Требования

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