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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

Члены

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

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

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

Flags

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

AllowMacSpoofing

Значение BOOLEAN , которое, если задано значение TRUE, указывает, что порту разрешено отправлять пакеты с mac-адресом, отличным от его постоянного MAC-адреса. Постоянный MAC-адрес порта настраивается с помощью запроса на набор идентификатора объекта (OID) OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Значение BOOLEAN , если задано значение TRUE, указывает, что порт должен сохранять сведения о приоритете 802.1Q в структуре NET_BUFFER_LIST пакета при пересылке пакета на порт. Порт должен сохранять сведения о приоритете только в том случае, если элемент PreservePriority задан в NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO объединении данных внешнего канала структуры NET_BUFFER_LIST пакета.

VirtualSubnetId

Значение UINT32, указывающее виртуальный идентификатор виртуализации сети , настроенный на порту. Если виртуализация сети не настроена на порту, значение будет равно 0. Данные NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO NET_BUFFER_LIST содержат VirtualSubnetId, который заполняется членством в виртуальной подсети трафика.

AllowTeaming

Значение BOOLEAN , которое, если задано в значение TRUE, указывает, что отработка отказа в команде для порта разрешена, так что порт может отправлять пакеты с MAC-адресом, отличным от его PermanentMacAddress, но равным MAC-адресу, используемому в настоящее время другим портом, подключенным к той же виртуальной машине. Постоянный MAC-адрес порта настраивается с помощью запроса на набор идентификатора объекта (OID) OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE.

DynamicIPAddressLimit

Значение UINT32, указывающее максимальное число динамических IP-адресов, которые можно узнать для порта.

Структура NDIS_SWITCH_PORT_PROPERTY_SECURITY соответствует структуре NDIS_SWITCH_PORT_PROPERTY_PARAMETERS в буфере, связанной с этими запросами наборов OID. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на этот буфер.

Свойства порта, такие как NDIS_SWITCH_PORT_PROPERTY_SECURITY, применяются расширением расширяемого коммутатора, которое устанавливается в качестве расширения переадресации. Этот тип расширения применяет собственные правила для переадресации пакетов, идентификаторов OID и индикации состояния через стек драйвера расширяемого коммутатора. На каждый экземпляр расширяемого коммутатора может быть только одно расширение переадресации.

Дополнительные сведения о переадресации расширений см. в разделе Переадресация расширений.

Примечание Если расширение переадресации не установлено, интерфейс расширяемого коммутатора принудительно применяет само свойство порта.

Требования

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