struttura NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_NIC_SWITCH_VF_INFO specifica le informazioni su una funzione virtuale PCI Express (PCIe) allocata nella scheda di rete.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_NIC_SWITCH_VF_INFO . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_NIC_SWITCH_VF_INFO , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Versione originale per NDIS 6.30.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

SwitchId

Valore NDIS_NIC_SWITCH_ID che specifica un identificatore di opzione. L'identificatore del commutatore è un numero intero compreso tra zero e il numero di commutatori supportati dalla scheda di rete. Un valore NDIS_DEFAULT_SWITCH_ID indica il commutatore della scheda di rete predefinito.

Nota A partire da Windows Server 2012, l'interfaccia SR-IOV (Single Root I/O Virtualization) supporta solo il commutatore di scheda di rete predefinito nella scheda di rete. Il valore di questo membro deve essere impostato su NDIS_DEFAULT_SWITCH_ID.

VMName

Valore NDIS_VM_NAME che specifica il nome della partizione figlio Hyper-V collegata alla VF. Questo membro contiene la descrizione descrittiva della partizione.

Nota La partizione figlio Hyper-V è nota anche come macchina virtuale.The Hyper-V child partition is also known as a virtual machine (VM).

VMFriendlyName

Valore NDIS_VM_FRIENDLYNAME che specifica il nome esterno della partizione figlio Hyper-V collegata alla VF. Questo membro contiene la descrizione descrittiva della partizione.

NicName

Valore NDIS_SWITCH_NIC_NAME che specifica il nome della scheda di rete della macchina virtuale. Questo membro contiene la descrizione descrittiva della scheda di rete.

La scheda di rete della macchina virtuale è un dispositivo virtuale esposto nel sistema operativo guest che viene eseguito in una partizione figlio Hyper-V. La scheda di rete vm è associata alla scheda di rete VF per fornire il percorso dati VF basato su hardware sull'interfaccia SR-IOV.

Per altre informazioni sul percorso dati VF, vedere Percorso dati SR-IOV VF.

MacAddressLength

Valore USHORT che specifica la lunghezza dei membri PermanentMacAddress e CurrentMacAddress .

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC permanente della VF. Questo è l'indirizzo MAC permanente per la scheda di rete VF esposta nel sistema operativo guest.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC corrente della VF. Questo è l'indirizzo MAC corrente per la scheda di rete VF esposta nel sistema operativo guest.

VFId

Valore NDIS_SRIOV_FUNCTION_ID che specifica l'identificatore univoco del VF nella scheda di rete.

RequestorId

Un NDIS_VF_RID che specifica l'ID del richiedente PCI Express (PCIe) del VF.

Commenti

Una struttura NDIS_NIC_SWITCH_VF_INFO contiene informazioni su un VF creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF. Quando viene eseguita questa richiesta OID, una o più strutture NDIS_NIC_SWITCH_VF_INFO vengono restituite all'interno di una struttura NDIS_NIC_SWITCH_VF_INFO_ARRAY .

Per altre informazioni sull'interfaccia SR-IOV, vedere Panoramica di Single Root I/O Virtualization (SR-IOV).For more information about the SR-IOV interface, see Overview of Single Root I/O Virtualization (SR-IOV).