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 formato de estructura NDIS_OBJECT_HEADER .
El controlador de minipuerto debe establecer el miembro Type de Header 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 valores siguientes:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Se agregó el campo QosSqId para NDIS 6.50.
Establezca el miembro Size 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 Size 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 se reserva para uso futuro. Los controladores de minipuerto deben ignorar esta marca.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Esta marca especifica que el miembro Flags se ha actualizado después de crear la VPort. Estas marcas se pueden habilitar o deshabilitar después de crear 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 la 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 el miembro InterruptModeration se ha actualizado después de crear la 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 una vez creado 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 la VPort. La afinidad de procesador de una VPort solo se puede actualizar si la VPort está conectada al PF en el adaptador de red. El miembro ProcessoryAffinity 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 la VPort. Cuando se habilitan varias colas de máquina virtual (VMMQ), se puede actualizar el número de colas para Vports predeterminados y no predeterminados. El miembro NumQueuePairs se puede actualizar mediante una solicitud 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 la 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 una 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 miniport 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
Se reserva un identificador VPort de NDIS_DEFAULT_VPORT_ID para el VPort predeterminado que está asociado al PF en el conmutador NIC predeterminado.
VPortName
Valor de 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 la VPort está asociada al PF. Si el valor es un identificador VF válido, el 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 conmutador a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_SWITCH. Uno o varios pares de colas 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 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 especifique solo un procesador cuando se cree la VPort. Las VPorts se crean 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 al PF se puede cambiar después de la creación de VPort. La afinidad de procesador asociada con la VPort predeterminada también se puede cambiar mediante una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Este miembro se reserva para uso futuro. Este miembro debe establecerse en cero.
NdkParams
QosSqId
Asocia una instancia de vPort a una cola de Scheduler (SQ). Establezca este campo en un id. 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, consulte OID_QOS_OFFLOAD_CREATE_SQ.
Comentarios
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 SR-IOV, vea Información general sobre la virtualización de E/S raíz única (SR-IOV).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con NDIS 6.30 y versiones posteriores. |
| Servidor mínimo compatible | Windows Server 2022 |
| Encabezado | ntddndis.h (include Ndis.h) |