estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM (ntddndis.h)

Artigo
08/07/2023

A estrutura de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM especifica as informações de status personalizadas para 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).

Sintaxe

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusBufferLength;
  ULONG              FeatureStatusBufferOffset;
} NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM . 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_CUSTOM , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1.

Flags

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

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_CUSTOM. O deslocamento é medido desde o início da estrutura de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM até o início do buffer de status do recurso.

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 para o recurso status informações que devem ser retornadas para uma porta de comutador 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 hyper-v preenche todos os outros membros ao emitir o OID de consulta.
Uma estrutura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM que contém o recurso status dados para a porta de comutador extensível especificada. 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.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.