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

  • Статья

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

Синтаксис

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

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

PropertyType

Значение перечисления NDIS_SWITCH_PORT_PROPERTY_TYPE , указывающее тип свойства порта. При выдаче запроса метода OID OID_SWITCH_PORT_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_PORT_PROPERTY_ENUM_INFO , следующего за NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS структурой. Смещение измеряется от начала структуры NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS до начала первого элемента массива.

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

NumProperties

Значение ULONG, указывающее количество элементов NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO , следующих за NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS структурой.

Reserved

Зарезервировано для последующего использования.

Комментарии

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

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

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

Требования

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

См. также раздел

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO

OID_SWITCH_PORT_PROPERTY_ENUM