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

Статья
02/07/2025

Структура 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.

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

NDIS_SWITCH_PARAMETERS_REVISION_1

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

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

Flags

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

SwitchName

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

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

SwitchFriendlyName

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

NumSwitchPorts

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

IsActive

ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, указывающее, что активация Hyper-V расширяемого коммутатора завершена и безопасно запрашивать другую конфигурацию коммутатора, например перечисление портов, сетевых адаптеров и свойств. Если значение FALSE, расширение должно ожидать, пока NetEventSwitchActivate событие PNP будет выдано перед запросом конфигурации коммутатора.

Замечания

Структура NDIS_SWITCH_PARAMETERS используется в запросе OID OID_SWITCH_PARAMETERS.

Эта структура также передается в параметре vSwitch следующих функций выноски для драйверов выноски платформы фильтрации Windows:

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

Требования

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