estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY (ntddndis.h)

  • Artigo

A estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY especifica uma matriz. Cada elemento na matriz especifica os atributos de uma porta virtual (VPort) que foi criada no comutador de adaptador de rede de um adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Membros

Header

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

O NDIS define o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , o NDIS define o membro Revision de Header como o seguinte valor:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit dos seguintes sinalizadores:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Esse sinalizador especifica enumerar as VPorts anexadas a uma função PCI Express (PCIe) específica. A função é especificada no membro AttachedFunctionId . Esse sinalizador pode ser usado para enumerar os VPorts anexados à função física pcie (PF) ou a uma VF (função virtual pcie) especificada.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Esse sinalizador especifica enumerar os VPorts criados em um comutador específico, especificado pela SwitchId. Isso enumera todos os VPorts criados na opção.

Nota Esses sinalizadores são mutuamente exclusivos. Somente um sinalizador pode ser definido no membro Flags .
 

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.

O membro SwitchId só será válido se NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH for especificado no membro Flags .

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.
 

AttachedFunctionId

Um valor NDIS_SRIOV_FUNCTION_ID que especifica o identificador do PF ou de uma VF no adaptador de rede.

Nota Se esse valor for NDIS_PF_FUNCTION_ID, o VPort será anexado ao PF.
 
O membro AttachedFunctionId só será válido se NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION for especificado no membro Flags .

FirstElementOffset

Um valor ULONG que especifica o deslocamento, em bytes, para o primeiro elemento em uma matriz de elementos que seguem essa estrutura. O deslocamento é medido desde o início da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_NIC_SWITCH_VPORT_INFO .

Nota Se NumElements estiver definido como zero, esse membro será ignorado.
 

NumElements

Um valor ULONG que especifica o número de elementos que seguem a estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

ElementSize

Um valor ULONG que especifica o tamanho, em bytes, de cada elemento que segue a estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

Comentários

O NDIS retorna uma estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY quando o NDIS manipula uma solicitação de método OID de OID_NIC_SWITCH_ENUM_VPORTS. Cada elemento na matriz que segue a estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY é um
NDIS_NIC_SWITCH_VPORT_INFO estrutura.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.30 e posterior.
Cabeçalho ntddndis.h (inclua Ndis.h)

Confira também

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS