Leer en inglés

Compartir a través de


estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS (ntddndis.h)

La estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS 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_PARAMETERS {
  NDIS_OBJECT_HEADER                         Header;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  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;
  NDIS_NDK_PARAMETERS                        NdkParams;
  NDIS_QOS_SQ_ID                             QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;

Miembros

Header

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

El controlador de miniport debe establecer el miembro Type de Encabezado en NDIS_OBJECT_TYPE_DEFAULT.

Para indicar la versión de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS, establezca el miembro Revision de Header en uno de los siguientes valores:

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2

Se agregó el campo QosSqId para NDIS 6.50.

Establezca el miembro Size de en NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2.

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de en NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de marcas. Las marcas siguientes se definen para este miembro.

NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED

Esta marca está reservada para uso futuro. Los controladores de miniport deben ignorar esta marca.

NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED

Esta marca especifica que el miembro Marcas se ha actualizado después de crear el VPort. Estas marcas se pueden habilitar o deshabilitar después de que se haya creado VPort mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota

Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED

Esta marca especifica que el miembro VPortName se ha actualizado después de crear el VPort. Este miembro se puede actualizar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota

Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED

Esta marca especifica que se ha actualizado el miembro InterruptModeration después de crear el VPort. Este miembro se puede actualizar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota

Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

Esta marca especifica que el miembro VPortState se ha actualizado después de crear el VPort. Este miembro se puede actualizar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota

Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

Esta marca especifica que el miembro ProcessoryAffinity se ha actualizado después de crear el VPort. La afinidad de procesador de una VPort solo se puede actualizar si el VPort está conectado al PF en el adaptador de red. El miembro processoryAffinity de se puede actualizar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota

Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED

Esta marca especifica que el miembro NumQueuePairs se ha actualizado después de crear el VPort. Cuando se habilita de varias colas de máquina virtual (VMMQ), se puede actualizar el número de colas para las Vports predeterminadas y no predeterminadas. El miembro NumQueuePairs se puede actualizar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Nota Esta marca solo es válida cuando esta estructura se usa en solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
 

SwitchId

Valor NDIS_NIC_SWITCH_ID que especifica el identificador del conmutador en el que se va a crear el VPort.

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.

VPortId

Valor NDIS_NIC_SWITCH_VPORT_ID que especifica el identificador de un VPort en el adaptador de red. El valor se asigna mediante NDIS y es único en el adaptador de red.

El valor de VPortId está dentro del intervalo comprendido entre cero y (NumVPorts - 1), donde NumVPorts es el número de VPorts que el controlador de miniporte ha configurado en el adaptador de red. El controlador especifica este número en el miembro NumVPorts de la estructura NDIS_NIC_SWITCH_INFO. El controlador devuelve esta estructura a través de una solicitud de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES.

Nota

Un identificador VPort de NDIS_DEFAULT_VPORT_ID está reservado para el VPort predeterminado que está conectado al PF en el conmutador NIC predeterminado.

VPortName

Valor NDIS_VPORT_NAME que especifica el nombre de VPort. Este miembro contiene una descripción fácil de usar de VPort.

AttachedFunctionId

Valor de NDIS_SRIOV_FUNCTION_ID que especifica el identificador de la función física (PF) o la función virtual (VF) a la que está asociada la VPort. Un valor de NDIS_PF_FUNCTION_ID especifica que el VPort está asociado al PF. Si el valor es un identificador VF válido, VPort se adjunta al VF.

NumQueuePairs

Valor de 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 modificador 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 NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION que especifica la configuración de moderación de interrupciones de VPort.

VPortState

Valor NDIS_NIC_SWITCH_VPORT_STATE que especifica el estado actual de VPort.

ProcessorAffinity

Valor GROUP_AFFINITY que especifica el número de grupo y un mapa de bits de las CPU a las que está asociada esta VPort. Este campo solo es válido para VPorts que están conectados al PF.

Nota

En el caso de VPorts pf no predeterminados, se debe especificar un valor de GROUP_AFFINITY que especifica solo un procesador cuando se crea el VPort. VPorts se crea a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.

La afinidad de procesador asociada a la VPort no predeterminada conectada a pf se puede cambiar después de la creación de VPort. La afinidad de procesador asociada a la VPort predeterminada también se puede cambiar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

LookaheadSize

Este miembro está reservado para uso futuro. Este miembro debe establecerse en cero.

NdkParams

QosSqId

Asocia una vPort a una cola de Scheduler (SQ). Establezca este campo en un identificador de SQ válido para asociar vPort a un SQ. Establezca este campo en cero si no hay ninguna asociación SQ. Para obtener más información sobre NDIS_QOS_SQ_ID, vea OID_QOS_OFFLOAD_CREATE_SQ.

Observaciones

Esta estructura se usa en solicitudes OID de OID_NIC_SWITCH_CREATE_VPORT y OID_NIC_SWITCH_VPORT_PARAMETERS.

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

Requisitos

Requisito Valor
cliente mínimo admitido Compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido Windows Server 2022
encabezado de ntddndis.h (include Ndis.h)

Consulte también

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_SWITCHES

OID_NIC_SWITCH_VPORT_PARAMETERS