NDIS_SWITCH_PORT_PROPERTY_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS especifica os parâmetros para uma propriedade de política de uma porta de comutador extensível 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 tipo do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, o membro de revisão do de cabeçalho deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1.

Flags

Um valor ULONG que contém um or bit a bit de sinalizadores. Este 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 valor de enumeração NDIS_SWITCH_PORT_PROPERTY_TYPE que especifica o tipo de propriedade de porta contida no buffer de propriedade.

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.

Observação 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 de porta serializada. 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 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 de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS até o início do buffer de propriedade.

Reserved

Reservado para uso futuro.

Observações

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 propriedade segue a estrutura NDIS_SWITCH_PORT_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.

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 de NDIS_SWITCH_PORT_PROPERTY_SECURITY.
Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeVlan, o buffer de propriedade será formatado como uma estrutura de NDIS_SWITCH_PORT_PROPERTY_VLAN.
Se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeProfile, o buffer de propriedade será formatado como uma estrutura de 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 de software independente) criou para a propriedade de porta personalizada. O buffer de propriedade é formatado como uma estrutura de NDIS_SWITCH_PORT_PROPERTY_CUSTOM que contém os parâmetros para a propriedade de porta personalizada, conforme definido pelo ISV.

Extensíveis 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ível, consulte Hyper-V Políticas de Comutador Extensível.