estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY (ntddndis.h)

Artigo
03/01/2024

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 Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY , o NDIS define o membro Revision do Header com o seguinte valor:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size 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 for definido, o driver de miniporto só deverá retornar uma matriz de estruturas NDIS_NIC_SWITCH_VF_INFO para VFs que foram alocadas no comutador de adaptador de rede especificado pelo membro SwitchId . 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 NDIS_NIC_SWITCH_VF_INFO para cada VF alocado em cada comutador de adaptador de rede do adaptador de rede.

Nota Começando com 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 miniporta só deve retornar uma matriz de estruturas de NDIS_NIC_SWITCH_VF_INFO para cada VF alocado 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 opções 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 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 .

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

Comentários

O NDIS retorna uma estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY quando manipula 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.