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

Статья
02/29/2024

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

Синтаксис

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_INFO;

Члены

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_REVISION_1

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

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

Flags

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

PropertyVersion

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

PropertyInstanceId

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

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

Примечание Это значение должно быть меньше или равно значению элемента QwordAlignedPropertyBufferLength .

PropertyBufferOffset

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

Структура NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO используется в запросах метода 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_INFO в массиве, с помощью макроса NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_GET_NEXT .

Расширения расширяемого коммутатора могут обращаться к буферу свойств портов, указанному в структуре NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO , с помощью макроса NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_GET_PROPERTY .

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

Требования

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