estructura NDIS_NIC_SWITCH_VF_INFO_ARRAY (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_NIC_SWITCH_VF_INFO_ARRAY especifica una matriz. Cada elemento de la matriz especifica los atributos de las funciones virtuales de PCI Express (PCIe) que se han habilitado y asignado en un adaptador de red.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_NIC_SWITCH_VF_INFO_ARRAY . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

NDIS establece el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_NIC_SWITCH_VF_INFO_ARRAY , NDIS establece el miembro Revision de Header en el siguiente valor:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de las marcas siguientes:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Si se establece esta marca, el controlador de minipuerto solo debe devolver una matriz de estructuras de NDIS_NIC_SWITCH_VF_INFO para las máquinas virtuales que se han asignado en el conmutador de adaptador de red especificado por el miembro SwitchId . Para obtener más información, vea la sección Comentarios.

Si el miembro Flags está establecido en cero, el controlador de minipuerto debe devolver una matriz de estructuras de NDIS_NIC_SWITCH_VF_INFO para cada VF que se haya asignado en cada conmutador de adaptador de red del adaptador de red.

Nota A partir de Windows Server 2012, la interfaz SR-IOV solo admite el conmutador de adaptador de red predeterminado en el adaptador de red. Por lo tanto, el controlador de minipuerto solo debe devolver una matriz de estructuras de NDIS_NIC_SWITCH_VF_INFO para cada VF que se haya asignado en el conmutador de adaptador de red predeterminado.

SwitchId

Valor de NDIS_NIC_SWITCH_ID que especifica un identificador de modificador. El identificador del conmutador es un entero entre cero y el número de conmutadores que admite el adaptador de red. Un valor de NDIS_DEFAULT_SWITCH_ID indica el conmutador de adaptador de red predeterminado.

Nota A partir de Windows Server 2012, la interfaz SR-IOV solo admite el conmutador de adaptador de red predeterminado que se crea en el adaptador de red. Por lo tanto, este miembro siempre debe establecerse en NDIS_DEFAULT_SWITCH_ID.

FirstElementOffset

Valor ULONG que especifica el desplazamiento, en bytes, al primer elemento de una matriz de elementos que siguen esta estructura. El desplazamiento se mide desde el principio de la estructura de NDIS_NIC_SWITCH_VF_INFO_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_NIC_SWITCH_VF_INFO .

Nota Si NumElements se establece en cero, se omite este miembro.

NumElements

Valor ULONG que especifica el número de elementos que siguen a la estructura NDIS_NIC_SWITCH_VF_INFO_ARRAY .

ElementSize

Valor ULONG que especifica el tamaño, en bytes, de cada elemento que sigue la estructura NDIS_NIC_SWITCH_VF_INFO_ARRAY .

Comentarios

NDIS devuelve una estructura de NDIS_NIC_SWITCH_VF_INFO_ARRAY cuando controla una solicitud de método OID de OID_NIC_SWITCH_ENUM_VFS. Cada elemento de la matriz que sigue a la estructura de NDIS_NIC_SWITCH_VF_INFO_ARRAY es un
NDIS_NIC_SWITCH_VF_INFO estructura.