NDIS_NIC_SWITCH_VPORT_INFO estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_NIC_SWITCH_VPORT_INFO especifica a configuração de uma porta virtual (VPort) em um comutador de adaptador de rede do adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_NIC_SWITCH_VPORT_INFO. 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 de NDIS_NIC_SWITCH_VPORT_INFO, o driver deve definir o membro de Revisão do de Cabeçalho com o seguinte valor:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1.

VPortId

Um valor NDIS_NIC_SWITCH_VPORT_ID que identifica exclusivamente a porta virtual (VPort) no adaptador de rede.

Um valor de NDIS_DEFAULT_VPORT_ID especifica o VPort padrão na opção. O VPort padrão é sempre anexado à função física PCI Express (PCIe) do adaptador de rede.

Observação Um VPort não padrão com o valor de VPortId especificado deve ter sido criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

Flags

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

SwitchId

Um valor NDIS_NIC_SWITCH_ID que identifica exclusivamente um comutador de adaptador de rede que foi criado no adaptador de rede. O VPort identificado por meio do membro VPortId é criado na opção especificada pelo membro SwitchId.

O identificador de comutador é um inteiro entre zero e o número de comutadores compatíveis com o adaptador de rede. Um valor de 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.

VPortName

Um valor NDIS_VPORT_NAME que especifica o nome do VPort que foi criado no comutador do adaptador de rede. Este membro contém a descrição amigável do VPort.

AttachedFunctionId

Um valor NDIS_SRIOV_FUNCTION_ID que especifica o identificador de um VF ou PF ao qual o VPort está anexado.

Observação Se esse valor for NDIS_PF_FUNCTION_ID, o VPort será anexado ao PF.

NumQueuePairs

Um valor ULONG que especifica o número de pares de fila configurados para este VPort.

Um par de filas consiste em uma fila de transmissão e fila de recebimento. Os pares de fila associados ao VPort padrão são configurados no momento da criação do comutador por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH. Um ou mais pares de fila são configurados em um VPort não padrão por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

InterruptModeration

Um valor NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION que especifica a configuração de moderação de interrupção do VPort.

VPortState

Um valor NDIS_NIC_SWITCH_VPORT_STATE que especifica o estado do VPort.

ProcessorAffinity

Um valor GROUP_AFFINITY que especifica o número do grupo e um bitmap das CPUs às quais esse VPort pode ser associado.

Esse membro é válido apenas para os VPorts anexados ao PF. Esse campo não é válido para VPorts não padrão anexados a uma VF.

LookaheadSize

Esse membro é reservado para uso futuro. Esse membro deve ser definido como zero.

NumFilters

Um valor ULONG que especifica o número de filtros de recebimento que foram configurados no adaptador de rede.

Observação Começando com o NDIS 6.30, o driver de miniporto deve manter um contador para o número atual de filtros de recebimento definidos no adaptador de rede. O driver deve incrementar o contador sempre que um filtro de recebimento for definido por meio de uma solicitação de conjunto de OID de OID_RECEIVE_FILTER_SET_FILTER. O driver também deve decrementar o contador sempre que um filtro de recebimento for limpo por meio de uma solicitação de conjunto de OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

Observações

Uma estrutura NDIS_NIC_SWITCH_VPORT_INFO contém informações sobre um dos seguintes:

Um VPort não padrão criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.
O VPort padrão anexado ao PF. O VPort padrão sempre existe e não pode ser excluído.

Uma ou mais estruturas NDIS_NIC_SWITCH_VPORT_INFO são retornadas por meio da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY.

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).