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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_PARAMETERS_REVISION_1

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

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

Flags

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

SwitchName

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

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

SwitchFriendlyName

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

NumSwitchPorts

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

IsActive

Значение BOOLEAN, если значение TRUE указывает, что активация расширяемого коммутатора Hyper-V завершена, и можно безопасно запрашивать другую конфигурацию коммутатора, например перечисление портов, сетевых адаптеров и свойств. При значении FALSE расширение должно ожидать, пока не будет выдано событие PNP NetEventSwitchActivate , прежде чем запрашивать конфигурацию коммутатора.

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

Требования

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