Compartilhar via


NDIS_NIC_SWITCH_VF_INFO_ARRAY estrutura (ntddndis.h)

A estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY especifica uma matriz. Cada elemento na matriz especifica os atributos de uma VF (funções virtuais) PCI Express (PCIe) que foram habilitadas e alocadas em um adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Membros

Header

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

O NDIS define o membro tipo do de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_NIC_SWITCH_VF_INFO_ARRAY, o NDIS define o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1.

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Se esse sinalizador estiver definido, o driver de miniporto só deverá retornar uma matriz de estruturas de NDIS_NIC_SWITCH_VF_INFO para VFs que foram alocadas no comutador de adaptador de rede especificado pelo membro switchId do. Para obter mais informações, consulte a seção Comentários.

Se o membro Flags estiver definido como zero, o driver de miniporto deverá retornar uma matriz de estruturas de NDIS_NIC_SWITCH_VF_INFO para cada VF alocado em cada comutador de adaptador de rede do adaptador de rede.

Observação Começando com o Windows Server 2012, a interface SR-IOV dá suporte apenas ao comutador de adaptador de rede padrão no adaptador de rede. Portanto, o driver de miniporto só deve retornar uma matriz de estruturas de NDIS_NIC_SWITCH_VF_INFO para cada VF que foi alocada no comutador de adaptador de rede padrão.
 

SwitchId

Um valor NDIS_NIC_SWITCH_ID que especifica 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 SR-IOV dá suporte apenas ao comutador de adaptador de rede padrão criado no adaptador de rede. Portanto, esse membro sempre deve ser definido como NDIS_DEFAULT_SWITCH_ID.
 

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_VF_INFO_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_NIC_SWITCH_VF_INFO.

Observação 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_VF_INFO_ARRAY.

ElementSize

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

Observações

O NDIS retorna uma estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY quando lida com uma solicitação de método OID de OID_NIC_SWITCH_ENUM_VFS. Cada elemento na matriz que segue a estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY é um
NDIS_NIC_SWITCH_VF_INFO estrutura.

Requisitos

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

Consulte também

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS