estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS especifica os parâmetros para as informações de status personalizadas de uma porta de 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_PORT_FEATURE_STATUS_CUSTOM e são retornadas por meio de uma solicitação de método OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Sintaxe

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;

Membros

Header

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

O membro Tipo de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

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

PortId

Um valor NDIS_SWITCH_PORT_ID que especifica o identificador numérico para uma porta de comutador extensível. Esse valor identifica exclusivamente a porta na opção extensível para qual recurso status informações devem ser retornadas.

FeatureStatusType

Um valor de enumeração NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE que especifica o tipo das informações de status para uma propriedade de perfil de porta de comutador extensível personalizada.

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

FeatureStatusId

Um valor NDIS_SWITCH_OBJECT_ID que identifica a propriedade de perfil para a porta de comutador extensível.

FeatureStatusVersion

Um valor NDIS_SWITCH_OBJECT_VERSION que identifica a versão da propriedade de perfil para a porta de comutador extensível.

SerializationVersion

Um valor NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica a versão de formato dos dados da propriedade de porta serializada. Esses dados são serializados para acesso pela extensão do arquivo MOF (Managed Object Format) que definiu a propriedade.

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

FeatureStatusInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que identifica a instância do recurso status informações para a porta de comutador extensível.

FeatureStatusBufferLength

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

FeatureStatusBufferOffset

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

O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS até o início da estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Reserved

Reservado para uso futuro.

Comentários

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

Uma estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS que especifica os parâmetros de uma propriedade personalizada de uma porta de comutador extensível para a qual status informações devem ser retornadas. 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 hyper-v preenche todos os outros membros ao emitir o OID de consulta.
Uma estrutura de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM que contém as informações de status para a propriedade de porta de comutador 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 hyper-v preenche todos os outros membros ao emitir o OID de consulta.