estrutura NDIS_SWITCH_PROPERTY_PARAMETERS (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_PROPERTY_PARAMETERS especifica os parâmetros de 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 de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PROPERTY_PARAMETERS , o membro Revision de Header 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 Size como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Um NDIS_SWITCH_PROPERTY_TYPE valor de enumeração 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.

Nota 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 do comutador extensível serializado. 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.

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 NDIS_SWITCH_PROPERTY_PARAMETERS até o início do buffer de propriedade.

Comentários

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 propriedades segue a estrutura NDIS_SWITCH_PROPERTY_PARAMETERS no buffer de informações associado a essas solicitações de conjunto de OID. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

Nota Começando com Windows Server 2012, o membro PropertyType deve ser definido como NdisSwitchPropertyTypeCustom e o buffer de propriedade deve conter uma estrutura NDIS_SWITCH_PROPERTY_CUSTOM.

As extensíveis extensíveis podem acessar o buffer de propriedades de comutador extensível dentro de uma estrutura NDIS_SWITCH_PROPERTY_PARAMETERS usando a macro NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY .

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