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

Структура NDIS_SWITCH_FEATURE_STATUS_PARAMETERS задает параметры для пользовательских сведений о состоянии расширяемого коммутатора Hyper-V. Эти сведения называются сведениями о состоянии функции . Формат этих сведений определяется независимым поставщиком программного обеспечения( ISV).

Сведения о состоянии указываются с помощью структуры NDIS_SWITCH_FEATURE_STATUS_CUSTOM , возвращаемой с помощью запроса метода идентификатора объекта (OID) OID_SWITCH_FEATURE_STATUS_QUERY.

Синтаксис

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

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

Flags

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

FeatureStatusType

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

Примечание Начиная с версии NDIS 6.30, для этого элемента необходимо задать значение NdisSwitchFeatureStatusTypeCustom.

 

FeatureStatusId

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

Это значение определяется в определении класса формата управляемого объекта (MOF) для сведений о состоянии компонента. Дополнительные сведения см. в разделе Определение и регистрация свойства настраиваемого коммутатора.

FeatureStatusInstanceId

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

FeatureStatusVersion

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

SerializationVersion

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

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

 

FeatureStatusBufferOffset

Значение ULONG, указывающее смещение в байтах в буфере состояния компонента, который следует за NDIS_SWITCH_FEATURE_STATUS_PARAMETERS структурой. Буфер состояния содержит структуру NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

Смещение измеряется от начала структуры NDIS_SWITCH_FEATURE_STATUS_PARAMETERS до начала структуры NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

FeatureStatusBufferLength

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

Комментарии

Структура NDIS_SWITCH_FEATURE_STATUS_PARAMETERS используется в запросах метода OID OID_SWITCH_FEATURE_STATUS_QUERY. Этот запрос OID возвращает следующие структуры в информационном буфере, связанном с запросом OID:

• Структура NDIS_SWITCH_FEATURE_STATUS_PARAMETERS , указывающая параметры состояния для сведений о состоянии компонента расширяемого коммутатора. Расширение switch заполняет элемент FeatureStatusVersion структуры, чтобы отразить версию настраиваемого состояния, возвращаемого в буфере NDIS_SWITCH_FEATURE_STATUS_CUSTOM. Параметр Hyper-v Extensible заполняет все остальные элементы при выдаче идентификатора запроса.
• Структура NDIS_SWITCH_FEATURE_STATUS_CUSTOM , содержащая сведения о состоянии функции для расширяемого коммутатора. Расширение switch заполняет элемент FeatureStatusCustomBufferLength структуры, чтобы отразить размер возвращаемого настраиваемого состояния. Параметр Hyper-v Extensible заполняет все остальные элементы при выдаче идентификатора запроса.

Требования

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

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

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY