estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS (ntddndis.h)

Artigo
03/08/2023

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

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_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;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Membros

Header

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1.

Flags

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

PortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta de comutador extensível à qual a propriedade é atribuída.

PropertyType

Um NDIS_SWITCH_PORT_PROPERTY_TYPE valor de enumeração que especifica o tipo de propriedade de porta contido no buffer de propriedades.

PropertyId

Um valor guid que identifica a propriedade para a porta 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 NdisSwitchPortPropertyTypeCustom.

PropertyVersion

Um valor NDIS_SWITCH_OBJECT_VERSION que identifica a versão da propriedade 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 da 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.

PropertyInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que identifica a instância da propriedade para a porta 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_PORT_PROPERTY_PARAMETERS . O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS até o início do buffer de propriedades.

Reserved

Reservado para uso futuro.

Comentários

A estrutura NDIS_SWITCH_PORT_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_PORT_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.

A extensão de comutador extensível deve seguir estas diretrizes ao processar uma estrutura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeSecurity, o buffer de propriedade será formatado como uma estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY .
Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeVlan, o buffer de propriedade será formatado como uma estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN .
Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeProfile, o buffer de propriedade será formatado como uma estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE .
Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeCustom, o membro PropertyId deverá ser definido como o valor GUID que o ISV (fornecedor independente de software) criou para a propriedade de porta personalizada. O buffer de propriedade é formatado como uma estrutura NDIS_SWITCH_PORT_PROPERTY_CUSTOM que contém os parâmetros para a propriedade de porta personalizada, conforme definido pelo ISV.

As extensões de comutador extensíveis podem acessar a propriedade de porta personalizada dentro de uma estrutura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS usando a macro NDIS_SWITCH_PORT_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.