estrutura NDIS_SWITCH_PARAMETERS (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_PARAMETERS contém os dados de configuração de um comutador extensível do 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 Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PARAMETERS , o membro Revision de Header deve ser definido com o seguinte valor:

NDIS_SWITCH_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Um valor NDIS_SWITCH_NAME que especifica o nome interno exclusivo da opção extensível.

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

SwitchFriendlyName

Um valor NDIS_SWITCH_FRIENDLYNAME que especifica a descrição amigável da opção 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 do Hyper-V foi concluída e é seguro consultar outras configurações de comutador, como enumeração de portas, NICs e propriedades. Se FALSE, a extensão deverá aguardar o evento PNP NetEventSwitchActivate ser emitido antes de consultar a configuração do comutador.

Comentários

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:

Nota Os tipos de dados NDIS_SWITCH_NAME e NDIS_SWITCH_FRIENDLYNAME são definidos pelo 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 Length dessa estrutura. Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de terminação.