estructura NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_NIC_SWITCH_VF_INFO especifica la información sobre una función virtual de PCI Express (PCIe) (VF) que se ha asignado en el adaptador de red.

Sintaxis

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

Miembros

Header

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Versión original de NDIS 6.30.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1.

Flags

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

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.

VMName

Valor NDIS_VM_NAME que especifica el nombre de la partición secundaria Hyper-V que está asociada al VF. Este miembro contiene la descripción fácil de usar de la partición.

Nota La partición secundaria de Hyper-V también se conoce como una máquina virtual (VM).

VMFriendlyName

Valor NDIS_VM_FRIENDLYNAME que especifica el nombre externo de la partición secundaria Hyper-V que está asociada al VF. Este miembro contiene la descripción fácil de usar de la partición.

NicName

Valor de NDIS_SWITCH_NIC_NAME que especifica el nombre del adaptador de red de la máquina virtual (VM). Este miembro contiene la descripción fácil de usar del adaptador de red.

El adaptador de red de máquina virtual es un dispositivo virtual que se expone en el sistema operativo invitado que se ejecuta en una partición secundaria de Hyper-V. Los equipos del adaptador de red de máquina virtual con el adaptador de red VF para proporcionar la ruta de acceso de datos de VF basada en hardware a través de la interfaz de SR-IOV.

Para obtener más información sobre la ruta de acceso de datos de VF, consulte SR-IOV ruta de acceso de datos de VF.

MacAddressLength

Valor de USHORT que especifica la longitud de los miembros PermanentMacAddress y CurrentMacAddress.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Dirección MAC permanente del VF. Esta es la dirección MAC permanente del adaptador de red VF que se expone en el sistema operativo invitado.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Dirección MAC actual del VF. Esta es la dirección MAC actual del adaptador de red VF que se expone en el sistema operativo invitado.

VFId

Valor NDIS_SRIOV_FUNCTION_ID que especifica el identificador único del VF en el adaptador de red.

RequestorId

Un NDIS_VF_RID que especifica el identificador de solicitante (RID) de PCI Express (PCIe) del VF.

Observaciones

Una estructura de NDIS_NIC_SWITCH_VF_INFO contiene información sobre una VF que se creó anteriormente a través de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF. Cuando se emite esta solicitud de OID, se devuelven una o varias estructuras de NDIS_NIC_SWITCH_VF_INFO dentro de una estructura de NDIS_NIC_SWITCH_VF_INFO_ARRAY.

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