estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Artigo
03/01/2024

A estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS especifica os parâmetros para as informações de status personalizadas de um comutador extensível do Hyper-V. Essas informações são conhecidas como informações de status de recursos. O formato dessas informações é definido pelo ISV (fornecedor independente de software).

As informações de status são especificadas por meio de uma estrutura NDIS_SWITCH_FEATURE_STATUS_CUSTOM retornada por meio de uma solicitação de método OID (identificador de objeto) de OID_SWITCH_FEATURE_STATUS_QUERY.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O membro Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS , o membro Revision de Header deve ser definido com o seguinte valor:

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para NDIS.

FeatureStatusType

Um NDIS_SWITCH_FEATURE_STATUS_TYPE valor de enumeração que especifica o tipo do recurso status informações para a opção extensível.

Nota A partir do NDIS 6.30, esse membro deve ser definido como NdisSwitchFeatureStatusTypeCustom.

FeatureStatusId

Um valor guid que identifica o recurso status informações para a opção extensível.

Esse valor é definido na definição de classe MOF (formato de objeto gerenciado) para o recurso status informações. Para obter mais informações, consulte Custom Switch Property Definition and Registration.

FeatureStatusInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que identifica a instância do recurso status informações para a opção extensível.

FeatureStatusVersion

Um valor NDIS_SWITCH_OBJECT_VERSION que identifica a versão do recurso status informações para a opção extensível. Esse valor é definido na definição de classe MOF para o recurso status informações.

SerializationVersion

Um valor NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica a versão de formato das informações de status serializadas para o recurso status informações. Esses dados são serializados para acesso pela extensão do arquivo MOF que definiu a propriedade .

Nota Para Windows Server 2012, o membro SerializationVersion deve ser definido como NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FeatureStatusBufferOffset

Um valor ULONG que especifica o deslocamento, em bytes, para o recurso status buffer que segue a estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS. O buffer status contém uma estrutura NDIS_SWITCH_FEATURE_STATUS_CUSTOM.

O deslocamento é medido desde o início da estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS até o início da estrutura NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

FeatureStatusBufferLength

Um valor ULONG que especifica o tamanho, em bytes, do recurso status buffer.

Comentários

A estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS é usada em solicitações de método OID de OID_SWITCH_FEATURE_STATUS_QUERY. Essa solicitação OID retorna as seguintes estruturas no buffer de informações associado à solicitação OID:

Uma estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS que especifica os parâmetros de status para o recurso status informações da opção extensível. A extensão de comutador preenche o membro FeatureStatusVersion da estrutura para refletir a versão do status personalizado que está sendo retornado no buffer NDIS_SWITCH_FEATURE_STATUS_CUSTOM. A opção Extensível do Hyper-v preenche todos os outros membros ao emitir o OID de consulta.
Uma estrutura NDIS_SWITCH_FEATURE_STATUS_CUSTOM que contém o recurso status informações para a opção extensível. A extensão de comutador preenche o membro FeatureStatusCustomBufferLength da estrutura para refletir o tamanho do status personalizado que está sendo retornado. A opção Extensível do Hyper-v preenche todos os outros membros ao emitir o OID de consulta.