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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Члены

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

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

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

Flags

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

PropertyInstanceId

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

PropertyVersion

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

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

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

PropertyBufferOffset

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

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

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

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

Требования

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