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

Статья
02/07/2025

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

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

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

Flags

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
заголовка	ntddndis.h (include Ndis.h)

См. также

NDIS_OBJECT_HEADER

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_TYPE

OID_SWITCH_PORT_FEATURE_STATUS_QUERY

Поделиться через