NDIS_SWITCH_PORT_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PORT_PARAMETERS contém os dados de configuração de uma porta de comutador extensível Hyper-V.

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_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 NDIS_SWITCH_PORT_PARAMETERS, o membro de Revisão do de Cabeçalho deve ser definido com o seguinte valor:

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PORT_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.

PortName

Um valor NDIS_SWITCH_PORT_NAME que especifica o nome interno exclusivo da porta de comutador extensível.

O nome da porta interna é usado por aplicativos de gerenciamento de políticas baseados em WMI. Para obter mais informações, consulte Gerenciamento de políticas de comutador extensível Hyper-V.

PortFriendlyName

Um valor NDIS_SWITCH_PORT_FRIENDLYNAME que especifica a descrição amigável da porta de comutador extensível.

PortType

Um valor NDIS_SWITCH_PORT_TYPE que especifica o tipo da porta de comutador extensível.

IsValidationPort

Se TRUE, indica uma porta que é criada temporariamente para fins de teste e validação antes que uma conexão de adaptador de rede de VM seja estabelecida. Para obter mais informações sobre esse tipo de porta, consulte Portas de Validação.

PortState

Um valor NDIS_SWITCH_PORT_STATE que especifica o estado atual da porta.

Observações

O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SWITCH_PORT_PARAMETERS para as seguintes solicitações de OID:

Solicitações de consulta OID de OID_SWITCH_PORT_ARRAY retornam uma estrutura NDIS_SWITCH_PORT_ARRAY que contém uma matriz de elementos. Cada elemento é formatado como uma estrutura NDIS_SWITCH_PORT_PARAMETERS.

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

Observação os tipos de dados NDIS_SWITCH_PORT_NAME e NDIS_SWITCH_PORT_FRIENDLYNAME são definidos por tipo pela estrutura de IF_COUNTED_STRING. Uma cadeia de caracteres definida por essa estrutura não precisa ser terminada em nulo. No entanto, o comprimento da cadeia de caracteres deve ser definido no membro comprimento dessa estrutura. Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de encerramento.