NDIS_SWITCH_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

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

Sintaxe

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Membros

Header

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

NDIS_SWITCH_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Um valor NDIS_SWITCH_NAME que especifica o nome interno exclusivo do comutador extensível.

O nome da opção 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.

SwitchFriendlyName

Um valor NDIS_SWITCH_FRIENDLYNAME que especifica a descrição amigável do comutador extensível.

NumSwitchPorts

Um valor UINT32 que especifica o número de portas configuradas na opção extensível.

IsActive

Um BOOLEAN que, se TRUE indicar que a ativação do comutador extensível Hyper-V foi concluída e é seguro consultar outra configuração de comutador, como enumerar portas, NICs e propriedades. Se FALSE, a extensão deverá aguardar o evento NetEventSwitchActivate PNP ser emitido antes de consultar a configuração do comutador.

Observações

A estrutura de NDIS_SWITCH_PARAMETERS é usada na solicitação OID de OID_SWITCH_PARAMETERS.

Essa estrutura também é passada no parâmetro vSwitch das seguintes funções de texto explicativo para drivers de texto explicativo da Plataforma de Filtragem do Windows:

Observação os tipos de dados NDIS_SWITCH_NAME e NDIS_SWITCH_FRIENDLYNAME são definidos por tipo pela estrutura 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.