estructura NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_NIC_SWITCH_VPORT_INFO especifica la configuración de un puerto virtual (VPort) en un conmutador de adaptador de red del adaptador de red.

Sintaxis

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Miembros

Header

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

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_NIC_SWITCH_VPORT_INFO , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1.

VPortId

Valor de NDIS_NIC_SWITCH_VPORT_ID que identifica de forma única el puerto virtual (VPort) en el adaptador de red.

Un valor de NDIS_DEFAULT_VPORT_ID especifica el VPort predeterminado en el conmutador. El VPort predeterminado siempre está conectado a la función física PCI Express (PCIe) del adaptador de red.

Nota Un VPort no predeterminado con el valor VPortId especificado debe haberse creado previamente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.

Flags

Valor ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

SwitchId

Valor de NDIS_NIC_SWITCH_ID que identifica de forma única un conmutador de adaptador de red que se creó en el adaptador de red. El VPort identificado a través del miembro VPortId se crea en el modificador especificado por el miembro SwitchId .

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

VPortName

Valor NDIS_VPORT_NAME que especifica el nombre del VPort que se creó en el conmutador del adaptador de red. Este miembro contiene la descripción fácil de usar de VPort.

AttachedFunctionId

Valor NDIS_SRIOV_FUNCTION_ID que especifica el identificador de un VF o el PF al que está asociado el VPort.

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

NumQueuePairs

Valor ULONG que especifica el número de pares de cola configurados para este VPort.

Un par de colas consta de una cola de transmisión y una cola de recepción. Los pares de cola asociados con el VPort predeterminado se configuran en el momento de la creación del conmutador a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_SWITCH. Uno o varios pares de cola se configuran en un VPort no predeterminado a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.

InterruptModeration

Valor de NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION que especifica el valor de moderación de interrupción de VPort.

VPortState

Valor de NDIS_NIC_SWITCH_VPORT_STATE que especifica el estado de VPort.

ProcessorAffinity

Valor de GROUP_AFFINITY que especifica el número de grupo y un mapa de bits de las CPU a las que se puede asociar este VPort.

Este miembro solo es válido para las VPort conectadas al PF. Este campo no es válido para VPorts no predeterminados que están conectados a un VF.

LookaheadSize

Este miembro se reserva para uso futuro. Este miembro debe establecerse en cero.

NumFilters

Valor de ULONG que especifica el número de filtros de recepción que se han configurado en el adaptador de red.

Nota A partir de NDIS 6.30, el controlador de minipuerto debe mantener un contador para el número actual de filtros de recepción establecidos en el adaptador de red. El controlador debe incrementar el contador cada vez que se establece un filtro de recepción a través de una solicitud de conjunto de OID de OID_RECEIVE_FILTER_SET_FILTER. El controlador también debe disminuir el contador cada vez que se borra un filtro de recepción mediante una solicitud de conjunto de OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

Comentarios

Una estructura de NDIS_NIC_SWITCH_VPORT_INFO contiene información sobre uno de los siguientes elementos:

Un VPort no predeterminado que se creó anteriormente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
VPort predeterminado que está asociado al PF. El VPort predeterminado siempre existe y no se puede eliminar.

Una o varias estructuras de NDIS_NIC_SWITCH_VPORT_INFO se devuelven a través de la estructura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

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