estructura NDIS_NIC_SWITCH_INFO (ntddndis.h)

Artículo
12/21/2023

La estructura NDIS_NIC_SWITCH_INFO especifica la información sobre un conmutador de adaptador de red en un adaptador de red.

Sintaxis

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Miembros

Header

Tipo, revisión y tamaño de la estructura de NDIS_NIC_SWITCH_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_INFO , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_NIC_SWITCH_INFO_REVISION_1

Versión original de NDIS 6.30.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

Valor de ULONG que contiene un or bit a bit de marcas de configuración que están habilitadas en el conmutador.

Nota Para NDIS 6.30, no se define ninguna marca de configuración para el modificador. El miembro Flags debe establecerse en cero.

SwitchType

Valor NDIS_NIC_SWITCH_TYPE que especifica el tipo del modificador.

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.

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 la descripción fácil de usar del modificador.

NumVFs

Valor 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 habilitadas pueden estar en un estado asignado o sin asignar.

NumAllocatedVFs

Valor de ULONG que especifica el número de máquinas virtuales que se han asignado en el conmutador de adaptador de red especificado por SwitchId. Las máquinas virtuales se asignan a través de solicitudes de conjunto de OID de OID_NIC_SWITCH_ALLOCATE_VF.

NumVPorts

Valor de ULONG que especifica el número de puertos virtuales (VPorts) configurados en el conmutador de adaptador de red especificado por SwitchId.

Este valor de ULONG es la suma de lo siguiente:

Número máximo de VPorts que se pueden crear mediante solicitudes de conjunto de OID de OID_NIC_SWITCH_CREATE_VPORT.
VPort predeterminado asociado a la función física (PF).

NumActiveVPorts

Valor de ULONG que especifica el número de VPorts que se han creado en el conmutador de adaptador de red especificado por SwitchId.

Nota Este valor de ULONG incluye el VPort predeterminado, además de los VPort no predeterminados creados a través de solicitudes de conjunto de OID de OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

Valor ULONG que especifica el número de pares de cola asignados para el VPort predeterminado. El VPort predeterminado siempre está asociado al PF.

Un par de colas consta de una cola de transmisión y una cola de recepción. El controlador de minipuerto asocia uno o varios pares de colas con el VPort predeterminado 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.

Nota A partir de NDIS 6.30, solo puede haber un par de colas que se pueda configurar para el VPort predeterminado.

NumQueuePairsForNonDefaultVPorts

Valor de ULONG que especifica el número de pares de cola asignados para los VPorts no predeterminados. Un VPort no predeterminado se puede conectar al PF o a cualquier VF del adaptador de red.

El controlador de minipuerto asocia uno o varios pares de cola a un VPort no predeterminado a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Valor de ULONG que especifica el número de filtros de direcciones MAC de unidifusión que se establecen actualmente en el VPort predeterminado que está conectado al PF del adaptador de red.

NumActiveNonDefaultVPortMacAddresses

Valor de ULONG que especifica el número de filtros de direcciones MAC de unidifusión que se establecen actualmente en VPorts no predeterminados.

NumActiveDefaultVPortVlanIds

Valor de ULONG que especifica el número de filtros de identificador de red de área local virtual (VLAN) que están establecidos actualmente en el VPort predeterminado.

NumActiveNonDefaultVPortVlanIds

Valor ULONG que especifica el número de filtros de identificador de VLAN que están establecidos actualmente en los VPorts no predeterminados.

Comentarios

La estructura NDIS_NIC_SWITCH_INFO se usa en las solicitudes de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES. Esta solicitud de OID se usa para enumerar los conmutadores del adaptador de red en un adaptador de red. Cuando se emite esta solicitud de OID, se devuelven una o varias estructuras de NDIS_NIC_SWITCH_INFO dentro de una estructura de NDIS_NIC_SWITCH_INFO_ARRAY .

Nota A partir de NDIS 6.30, solo el NDIS_NIC_SWITCH_INFO que describe la información sobre el conmutador de adaptador de red predeterminado se devuelve a través de una solicitud OID de OID_NIC_SWITCH_ENUM_SWITCHES.

Una estructura de NDIS_NIC_SWITCH_INFO contiene información sobre un conmutador de adaptador de red que se creó anteriormente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_SWITCH.

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