NDIS_NIC_SWITCH_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_NIC_SWITCH_PARAMETERS especifica os parâmetros de configuração de uma opção de adaptador de rede no adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_NIC_SWITCH_PARAMETERS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_PARAMETERS, o driver deve definir o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho do como NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Os sinalizadores a seguir são definidos para este membro.

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

Esse sinalizador especifica que o campo que foi atualizado na estrutura NDIS_NIC_SWITCH_PARAMETERS é o membro SwitchName.

Observação Esse sinalizador é válido somente quando essa estrutura é usada em uma solicitação de conjunto OID de OID_NIC_SWITCH_PARAMETERS.

SwitchType

Um valor de enumeração NDIS_NIC_SWITCH_TYPE que especifica o tipo do comutador do adaptador de rede.

Observação Começando com o Windows Server 2012, o Windows dá suporte apenas a um tipo de comutador de NdisNicSwitchTypeExternal. Um comutador externo especifica que as portas conectadas a esse tipo de comutador podem acessar a rede externa por meio da porta física no adaptador de rede. A VPort (porta virtual padrão) no comutador externo fornece conectividade de rede externa à pilha de virtualização executada no sistema operacional de gerenciamento da partição pai Hyper-V.

SwitchId

Um valor NDIS_NIC_SWITCH_ID que contém um identificador de comutador. O identificador de comutador é um inteiro entre zero e o número de comutadores compatíveis com o adaptador de rede. Um valor NDIS_DEFAULT_SWITCH_ID indica o comutador de adaptador de rede padrão.

Observação Começando com o Windows Server 2012, a interface de virtualização de E/S raiz única (SR-IOV) só dá suporte ao comutador de adaptador de rede padrão no adaptador de rede. O valor desse membro deve ser definido como NDIS_DEFAULT_SWITCH_ID.

SwitchFriendlyName

Um valor NDIS_NIC_SWITCH_FRIENDLYNAME que contém uma descrição para a opção.

NumVFs

Um valor ULONG que especifica o número de VFs (Funções Virtuais) PCI Express (PCIe) habilitadas no adaptador de rede. Os VFs são habilitados no adaptador quando a virtualização é habilitada por meio de uma chamada para NdisMEnableVirtualization.

Observação Antes que um VF possa ser anexado a uma partição filho Hyper-V, os recursos devem ser alocados para ele por meio de uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

NdisReserved1

Reservado para NDIS.

NdisReserved2

Reservado para NDIS.

NdisReserved3

Reservado para NDIS.

NumQueuePairsForDefaultVPort

Observações

A estrutura NDIS_NIC_SWITCH_PARAMETERS é usada em solicitações de método OID de OID_NIC_SWITCH_CREATE_SWITCH e OID_NIC_SWITCH_PARAMETERS. Essas solicitações OID definem ou consultam os parâmetros de configuração de um comutador de adaptador de rede.

Para obter mais informações sobre a interface SR-IOV, consulte Visão geral da virtualização de E/S de Raiz Única (SR-IOV).