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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

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

PropertyType

Значение перечисления NDIS_SWITCH_PORT_PROPERTY_TYPE , указывающее тип свойства порта, содержащегося в буфере свойств.

PropertyId

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

Дополнительные сведения см. в разделе «Примечания».

Примечание Расширение расширяемого коммутатора должно игнорировать этот элемент, если для элемента PropertyType не задано значение NdisSwitchPortPropertyTypeCustom.

PropertyVersion

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

SerializationVersion

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

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

PropertyInstanceId

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

PropertyBufferLength

Значение ULONG, указывающее размер буфера свойств в байтах.

PropertyBufferOffset

Значение ULONG, указывающее смещение в байтах буфера свойств, следующего за NDIS_SWITCH_PORT_PROPERTY_PARAMETERS структурой. Смещение измеряется от начала структуры NDIS_SWITCH_PORT_PROPERTY_PARAMETERS до начала буфера свойств.

Reserved

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

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

Расширение расширяемого коммутатора должно соответствовать следующим рекомендациям при обработке структуры NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Если для элемента PropertyType задано значение NdisSwitchPortPropertyTypeSecurity, буфер свойств форматируется как NDIS_SWITCH_PORT_PROPERTY_SECURITY структура.
Если для элемента PropertyType задано значение NdisSwitchPortPropertyTypeVlan, буфер свойств форматируется как NDIS_SWITCH_PORT_PROPERTY_VLAN структура.
Если для элемента PropertyType задано значение NdisSwitchPortPropertyTypeProfile, буфер свойств форматируется как NDIS_SWITCH_PORT_PROPERTY_PROFILE структура.
Если для элемента PropertyType задано значение NdisSwitchPortPropertyTypeCustom, то для элемента PropertyId необходимо задать значение GUID, созданное независимым поставщиком программного обеспечения (ISV) для свойства пользовательского порта. Буфер свойств отформатирован в виде структуры NDIS_SWITCH_PORT_PROPERTY_CUSTOM , которая содержит параметры для настраиваемого свойства порта в соответствии с определением независимого поставщика программного обеспечения.

Расширения расширяемого коммутатора могут обращаться к свойству пользовательского порта внутри структуры NDIS_SWITCH_PORT_PROPERTY_PARAMETERS с помощью макроса NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY .

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

Требования

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