NDIS_SWITCH_PROPERTY_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PROPERTY_PARAMETERS especifica os parâmetros para uma propriedade de política de um comutador extensível Hyper-V.

Sintaxe

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

Membros

Header

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

O membro tipo do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_PROPERTY_PARAMETERS, o membro de Revisão do de Cabeçalho deve ser definido como o seguinte valor:

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Um valor de enumeração NDIS_SWITCH_PROPERTY_TYPE que especifica o tipo de propriedade de comutador extensível contida no buffer de propriedade.

PropertyId

Um valor GUID que identifica a propriedade de comutador extensível.

Para obter mais informações, consulte a seção Comentários.

Observação A extensão de comutador extensível deve ignorar esse membro, a menos que o membro PropertyType esteja definido como NdisSwitchPropertyTypeCustom.

PropertyVersion

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

SerializationVersion

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

Observação para o Windows Server 2012, o membro serializationVersion deve ser definido como NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

PropertyInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que especifica o identificador de instância da propriedade de comutador extensível.

PropertyBufferLength

Um valor ULONG que especifica o tamanho, em bytes, do buffer de propriedade.

PropertyBufferOffset

Um valor ULONG que especifica o deslocamento, em bytes, para o buffer de propriedade que segue a estrutura NDIS_SWITCH_PROPERTY_PARAMETERS. O deslocamento é medido desde o início da estrutura de NDIS_SWITCH_PROPERTY_PARAMETERS até o início do buffer de propriedade.

Observações

A estrutura NDIS_SWITCH_PROPERTY_PARAMETERS é usada nas seguintes solicitações de conjunto de OID:

O buffer de propriedade contém uma estrutura associada ao membro PropertyType. O buffer de propriedade segue a estrutura de NDIS_SWITCH_PROPERTY_PARAMETERS no buffer de informações associado a essas solicitações de conjunto de OID. O informationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

Observação a partir do Windows Server 2012, o membro PropertyType deve ser definido como NdisSwitchPropertyTypeCustom e o buffer de propriedades deve conter uma estrutura NDIS_SWITCH_PROPERTY_CUSTOM.

As extensões de comutador extensível podem acessar o buffer de propriedade de comutador extensível dentro de uma estrutura de NDIS_SWITCH_PROPERTY_PARAMETERS usando a macro NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY.

Para obter mais informações sobre políticas de comutador extensível, consulte Hyper-V Políticas de Comutador Extensível.