структура NDIS_NIC_SWITCH_VPORT_PARAMETERS (ntddndis.h)
Структура 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.
Примечание
Этот флаг действителен только в том случае, если эта структура используется в запросах на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Этот флаг указывает, что член InterruptModeration был обновлен после создания VPort. Этот элемент можно обновить с помощью запроса на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.
Примечание
Этот флаг действителен только в том случае, если эта структура используется в запросах на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Этот флаг указывает, что член VPortState был обновлен после создания VPort. Этот элемент можно обновить с помощью запроса на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS.
Примечание
Этот флаг действителен только в том случае, если эта структура используется в запросах на набор 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.
Примечание
Этот флаг действителен только в том случае, если эта структура используется в запросах на набор 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.
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.
Комментарии
Эта структура используется в запросах OID OID_NIC_SWITCH_CREATE_VPORT и OID_NIC_SWITCH_VPORT_PARAMETERS.
Дополнительные сведения об интерфейсе SR-IOV см. в статье Обзор виртуализации однокорневого ввода-вывода (SR-IOV).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 6.30 и более поздних версиях. |
| Минимальная версия сервера | Windows Server 2022 |
| Верхняя часть | ntddndis.h (включая Ndis.h) |