estructura NDIS_NIC_SWITCH_PARAMETERS (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_NIC_SWITCH_PARAMETERS especifica los parámetros de configuración de un conmutador de adaptador de red en el adaptador de red.

Sintaxis

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_NIC_SWITCH_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 especificar la versión de la estructura de NDIS_NIC_SWITCH_PARAMETERS, el controlador debe establecer el miembro Revisión de de Encabezado en el siguiente valor:

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_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_PARAMETERS_SWITCH_NAME_CHANGED

Esta marca especifica que el campo que se ha actualizado en la estructura NDIS_NIC_SWITCH_PARAMETERS es el miembro SwitchName.

Nota Esta marca solo es válida cuando esta estructura se usa en una solicitud de conjunto de OID de OID_NIC_SWITCH_PARAMETERS.

SwitchType

Valor de enumeración NDIS_NIC_SWITCH_TYPE que especifica el tipo del conmutador de adaptador de red.

Nota a partir de Windows Server 2012, Windows solo admite un tipo de conmutador de NdisNicSwitchTypeExternal. Un conmutador externo especifica que los puertos conectados a este tipo de conmutador pueden acceder a la red externa a través del puerto físico del adaptador de red. El puerto virtual predeterminado (VPort) en el conmutador externo proporciona conectividad de red externa a la pila de virtualización que se ejecuta en el sistema operativo de administración de la partición primaria de Hyper-V.

SwitchId

Valor de NDIS_NIC_SWITCH_ID que contiene 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 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.

SwitchFriendlyName

Valor de NDIS_NIC_SWITCH_FRIENDLYNAME que contiene una descripción del modificador.

NumVFs

Valor de ULONG que especifica el número de funciones virtuales (VFs) de PCI Express (PCIe) que están habilitadas en el adaptador de red. Las máquinas virtuales están habilitadas en el adaptador cuando la virtualización está habilitada a través de una llamada a NdisMEnableVirtualization.

Nota Antes de que se pueda adjuntar un VF a una partición secundaria de Hyper-V, se deben asignar recursos para él a través de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

NdisReserved1

Reservado para NDIS.

NdisReserved2

Reservado para NDIS.

NdisReserved3

Reservado para NDIS.

NumQueuePairsForDefaultVPort

Observaciones

La estructura NDIS_NIC_SWITCH_PARAMETERS se usa en solicitudes de método OID de OID_NIC_SWITCH_CREATE_SWITCH y OID_NIC_SWITCH_PARAMETERS. Estas solicitudes OID establecen o consultan los parámetros de configuración de un conmutador de adaptador de red.

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