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

  • Статья

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

Сведения о состоянии указываются с помощью структуры NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM и возвращаются через запрос метода OID OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Синтаксис

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Члены

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

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

FeatureStatusType

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

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

FeatureStatusId

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

FeatureStatusVersion

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

SerializationVersion

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

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

FeatureStatusInstanceId

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

FeatureStatusBufferLength

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

FeatureStatusBufferOffset

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

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

Reserved

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

Комментарии

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

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

Требования

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

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

NDIS_OBJECT_HEADER

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_TYPE

OID_SWITCH_PORT_FEATURE_STATUS_QUERY