estrutura NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Artigo
08/07/2023

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 miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_VPORT_INFO , o driver deve definir o membro Revision de Header como o seguinte valor:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size 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 à PF (Função Física) PCI Express (PCIe) do adaptador de rede.

Nota Um VPort não padrão com o valor 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. Esse membro é reservado para o 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 número 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.

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.

VPortName

Um valor NDIS_VPORT_NAME que especifica o nome do VPort que foi criado na opção do adaptador de rede. Esse 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 o PF ao qual o VPort está anexado.

Nota 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 um VF.

LookaheadSize

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

Nota A partir do 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.

Comentários

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

Um VPort não padrão que foi 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 SR-IOV (Virtualização de E/S raiz única).