структура NDIS_SWITCH_PORT_DESTINATION (ndis.h)

Статья
02/07/2025

Структура NDIS_SWITCH_PORT_DESTINATION указывает порт назначения для расширяемого коммутатора Hyper-V, к которому будет доставлен пакет.

Синтаксис

typedef struct _NDIS_SWITCH_PORT_DESTINATION {
  NDIS_SWITCH_PORT_ID   PortId;
  NDIS_SWITCH_NIC_INDEX NicIndex;
  USHORT                IsExcluded : 1;
  USHORT                PreserveVLAN : 1;
  USHORT                PreservePriority : 1;
  USHORT                Reserved : 13;
} NDIS_SWITCH_PORT_DESTINATION, *PNDIS_SWITCH_PORT_DESTINATION;

Члены

PortId

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

NicIndex

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

Дополнительные сведения о значениях NDIS_SWITCH_NIC_INDEX см. в значения индекса сетевого адаптера.

Примечание Этот член должен указать значение индекса сетевого адаптера, который находится в подключенном состоянии. Нельзя указать значения индекса для сетевых адаптеров, которые находятся в созданном или отключенном состоянии. Дополнительные сведения о состояниях сетевого подключения см. в Hyper-V состояния расширяемого коммутатора и сетевых адаптеров.

IsExcluded

Если для этого элемента задано значение TRUE, пакет не будет доставлен в порт назначения.

PreserveVLAN

Если этот член имеет значение TRUE, сведения о виртуальной локальной сети виртуальной зоны 802.1Q сохраняются при доставке пакета в порт назначения.

PreservePriority

Если для этого элемента задано значение TRUE, сведения о приоритете 802.1Q будут сохранены при доставке пакета на конечный порт.

Reserved

Этот элемент зарезервирован для дальнейшего использования NDIS.

Замечания

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY содержит один или несколько элементов. Каждый элемент отформатирован как структура NDIS_SWITCH_PORT_DESTINATION.

Примечание Член NicIndex должен указать значение индекса сетевого адаптера, который находится в подключенном состоянии. Нельзя указать значения индекса для сетевых адаптеров, которые находятся в созданном или отключенном состоянии. Дополнительные сведения о состояниях сетевого подключения см. в Hyper-V состояния расширяемого коммутатора и сетевых адаптеров.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
заголовка	ndis.h (include Ndis.h)

См. также

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY

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