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

Статья
02/07/2025

Структура NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS задает массив свойств профиля для расширяемого коммутатора Hyper-V. Каждый элемент в массиве форматируется как структура NDIS_SWITCH_PROPERTY_ENUM_INFO.

Синтаксис

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

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

Flags

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

PropertyType

Значение перечисления NDIS_SWITCH_PROPERTY_TYPE, указывающее тип свойства расширяемого коммутатора. При выдаче запроса метода OID OID_SWITCH_PROPERTY_ENUM расширение расширяемого коммутатора возвращает расширяемые свойства коммутатора, соответствующие этому типу свойства.

PropertyId

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

SerializationVersion

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

Примечание для Windows Server 2012, элемент serializationVersion должен иметь значение NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FirstPropertyOffset

Значение USHORT, указывающее смещение (в байтах) к первому элементу NDIS_SWITCH_PROPERTY_ENUM_INFO, который следует NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS структуре. Смещение измеряется с начала NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS структуры до начала первого элемента в массиве.

Примечание Если значение NumProperties равно нулю, этот элемент игнорируется.

NumProperties

Значение ULONG, указывающее количество элементов NDIS_SWITCH_PROPERTY_ENUM_INFO, следовать NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS структуре.

Замечания

Структура NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS используется в запросах метода OID OID_SWITCH_PROPERTY_ENUM. Массив структур NDIS_SWITCH_PROPERTY_ENUM_INFO следует NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS структуре в буфере информации, связанном с этими запросами набора OID. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на этот буфер информации.

Расширения расширяемого коммутатора могут получить доступ к первой NDIS_SWITCH_PROPERTY_ENUM_INFO структуре, указанной структурой NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS с помощью макроса NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO.

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

Требования

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

См. также

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO

OID_SWITCH_PROPERTY_ENUM

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