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

Статья
08/07/2023

Структура NDIS_SWITCH_PORT_PARAMETERS содержит данные конфигурации для порта расширяемого коммутатора Hyper-V.

Синтаксис

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Члены

Header

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

Элемент Typeзаголовка должен иметь значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SWITCH_PORT_PARAMETERS , члену Редакциизаголовка необходимо задать следующее значение:

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

Значение NDIS_SWITCH_PORT_ID, содержащее уникальный идентификатор порта расширяемого коммутатора.

PortName

Значение NDIS_SWITCH_PORT_NAME, указывающее уникальное внутреннее имя порта расширяемого коммутатора.

Имя внутреннего порта используется приложениями управления политиками на основе WMI. Дополнительные сведения см. в статье Управление политиками расширяемого коммутатора Hyper-V.

PortFriendlyName

Значение NDIS_SWITCH_PORT_FRIENDLYNAME, указывающее понятное описание порта расширяемого коммутатора.

PortType

Значение NDIS_SWITCH_PORT_TYPE , указывающее тип порта расширяемого коммутатора.

IsValidationPort

Значение TRUE указывает порт, который временно создается для тестирования и проверки перед подключением к сетевому адаптеру виртуальной машины. Дополнительные сведения об этом типе порта см. в разделе Порты проверки.

PortState

Значение NDIS_SWITCH_PORT_STATE , указывающее текущее состояние порта.

Примечание Типы данных NDIS_SWITCH_PORT_NAME и NDIS_SWITCH_PORT_FRIENDLYNAME определяются IF_COUNTED_STRING структурой . Строка, определяемая этой структурой, не обязательно должна заканчиваться null. Однако длина строки должна быть задана в элементе Length этой структуры. Если строка заканчивается null, член Length не должен содержать завершающий символ NULL.

Требования

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