estructura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY especifica una matriz. Cada elemento de la matriz especifica los atributos de un puerto virtual (VPort) que se ha creado en el conmutador de adaptador de red de un adaptador de red.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_NIC_SWITCH_VPORT_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_VPORT_INFO_ARRAY , NDIS establece el miembro Revision de Header en el siguiente valor:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1.

Flags

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Esta marca especifica para enumerar las VPorts conectadas a una función específica de PCI Express (PCIe). La función se especifica en el miembro AttachedFunctionId . Esta marca se puede usar para enumerar las VPorts conectadas a la función física PCIe (PF) o a una función virtual PCIe especificada (VF).

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Esta marca especifica para enumerar las VPorts creadas en un conmutador específico, especificado por switchId. Esto enumera todos los VPorts creados en el conmutador.

Nota Estas marcas son mutuamente excluyentes. Solo se puede establecer una marca en el miembro Flags .

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.

El miembro SwitchId solo es válido si se especifica NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH en el miembro Flags .

Nota A partir de Windows Server 2012, la interfaz de virtualización de E/S raíz única (SR-IOV) solo admite el conmutador de adaptador de red predeterminado en el adaptador de red. El valor de este miembro debe establecerse en NDIS_DEFAULT_SWITCH_ID.

AttachedFunctionId

Valor de NDIS_SRIOV_FUNCTION_ID que especifica el identificador del PF o un VF en el adaptador de red.

Nota Si este valor es NDIS_PF_FUNCTION_ID, VPort se adjunta al PF.

El miembro AttachedFunctionId solo es válido si se especifica NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION en el miembro Flags .

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 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_NIC_SWITCH_VPORT_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_VPORT_INFO_ARRAY .

ElementSize

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

Comentarios

NDIS devuelve una estructura de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY cuando NDIS controla una solicitud de método OID de OID_NIC_SWITCH_ENUM_VPORTS. Cada elemento de la matriz que sigue a la estructura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY es un
NDIS_NIC_SWITCH_VPORT_INFO estructura.

Para obtener más información sobre la interfaz SR-IOV, vea Información general sobre la virtualización de E/S raíz única (SR-IOV).