estrutura NDIS_NIC_SWITCH_INFO (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_NIC_SWITCH_INFO especifica as informações sobre um comutador de adaptador de rede em um adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Membros

Header

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

O driver de miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_INFO , o driver deve definir o membro Revision de Header para o seguinte valor:

NDIS_NIC_SWITCH_INFO_REVISION_1

Versão original do NDIS 6.30.

Defina o membro Size como NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores de configuração habilitados no comutador.

Nota Para o NDIS 6.30, nenhum sinalizador de configuração é definido para a opção. O membro Flags deve ser definido como zero.

SwitchType

Um valor NDIS_NIC_SWITCH_TYPE que especifica o tipo da opção.

SwitchId

Um valor NDIS_NIC_SWITCH_ID que especifica um identificador de comutador. O identificador de comutador é um número 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.

Nota A partir do Windows Server 2012, a interface sr-IOV (virtualização de E/S raiz) 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 a descrição amigável da opção.

NumVFs

Um valor ULONG que especifica o número de VFs (Funções Virtuais) PCI Express (PCIe) habilitadas no adaptador de rede. As VFs habilitadas podem estar em um estado alocado ou não alocado.

NumAllocatedVFs

Um valor ULONG que especifica o número de VFs que foram alocados na opção de adaptador de rede especificada por SwitchId. As VFs são alocadas por meio de solicitações de conjunto de OID de OID_NIC_SWITCH_ALLOCATE_VF.

NumVPorts

Um valor ULONG que especifica o número de portas virtuais (VPorts) configuradas na opção de adaptador de rede especificada por SwitchId.

Esse valor ULONG é a soma do seguinte:

O número máximo de VPorts que podem ser criados por meio de solicitações de conjunto de OID de OID_NIC_SWITCH_CREATE_VPORT.
O VPort padrão anexado à Função Física (PF).

NumActiveVPorts

Um valor ULONG que especifica o número de VPorts que foram criados na opção de adaptador de rede especificada por SwitchId.

Nota Esse valor ULONG inclui o VPort padrão, além dos VPorts não padrão criados por meio de solicitações de conjunto de OID de OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

Um valor ULONG que especifica o número de pares de fila alocados para o VPort padrão. O VPort padrão é sempre anexado ao PF.

Um par de filas consiste em uma fila de transmissão e fila de recebimento. O driver de miniporto associa um ou mais pares de fila ao VPort padrão no momento da criação do comutador por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH.

Nota A partir do NDIS 6.30, só pode haver um par de filas que pode ser configurado para o VPort padrão.

NumQueuePairsForNonDefaultVPorts

Um valor ULONG que especifica o número de pares de fila alocados para os VPorts não padrão. Um VPort não padrão pode ser anexado ao PF ou a qualquer VF do adaptador de rede.

O driver de miniporto associa um ou mais pares de fila a um VPort não padrão por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Um valor ULONG que especifica o número de filtros de endereço MAC unicast que estão atualmente definidos no VPort padrão anexado ao PF do adaptador de rede.

NumActiveNonDefaultVPortMacAddresses

Um valor ULONG que especifica o número de filtros de endereço MAC unicast que estão atualmente definidos em VPorts não padrão.

NumActiveDefaultVPortVlanIds

Um valor ULONG que especifica o número de filtros de identificador de VLAN (rede local virtual) que estão atualmente definidos no VPort padrão.

NumActiveNonDefaultVPortVlanIds

Um valor ULONG que especifica o número de filtros de identificador de VLAN que estão atualmente definidos nos VPorts não padrão.

Comentários

A estrutura NDIS_NIC_SWITCH_INFO é usada em solicitações de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES. Essa solicitação OID é usada para enumerar os comutadores de adaptador de rede em um adaptador de rede. Quando essa solicitação OID é emitida, uma ou mais estruturas de NDIS_NIC_SWITCH_INFO são retornadas dentro de uma estrutura NDIS_NIC_SWITCH_INFO_ARRAY .

Nota A partir do NDIS 6.30, somente o NDIS_NIC_SWITCH_INFO que descreve as informações sobre o comutador de adaptador de rede padrão é retornado por meio de uma solicitação OID de OID_NIC_SWITCH_ENUM_SWITCHES.

Uma estrutura NDIS_NIC_SWITCH_INFO contém informações sobre um comutador de adaptador de rede que foi criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH.

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