struttura NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)
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.
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.
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).
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in NDIS 6.30 e versioni successive. |
Intestazione | ntddndis.h (include Ndis.h) |
Vedi anche