структура 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.

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

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

Flags

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

FeatureStatusType

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

FeatureStatusId

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

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

FeatureStatusInstanceId

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

FeatureStatusVersion

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

SerializationVersion

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

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 заполняет все остальные члены при выдаче OID запроса.
• Структура NDIS_SWITCH_FEATURE_STATUS_CUSTOM, содержащая сведения о состоянии функции для расширяемого коммутатора. Расширение коммутатора заполняет элемент FeatureStatusCustomBufferLength, чтобы отразить размер возвращаемого пользовательского состояния. Переключение Hyper-v Extensible заполняет все остальные члены при выдаче OID запроса.

Требования

См. также

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY