NDIS_NIC_SWITCH_VF_PARAMETERS struttura (ntddndis.h)

Articolo
08/07/2023

La NDIS_NIC_SWITCH_VF_PARAMETERS specifica i parametri delle risorse di una funzione virtuale PCI Express (PCIe) in una scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  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_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_NIC_SWITCH_VF_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_NIC_SWITCH_VF_PARAMETERS , il driver deve impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_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 commutatore. Questo valore identifica l'interruttore della scheda di rete in cui viene allocato il VF.

L'identificatore del commutatore è un 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 I/O (SR-IOV) singola supporta solo l'opzione scheda di rete predefinita 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 interno della partizione figlio Hyper-V collegata al VF.

Nota La partizione figlio Hyper-V è nota anche come macchina virtuale.

VMFriendlyName

Valore NDIS_VM_FRIENDLYNAME che specifica il nome esterno della partizione figlio Hyper-V collegata al 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 della macchina virtuale è in team con la scheda di rete VF per fornire il percorso dati VF basato su hardware sull'interfaccia SR-IOV.

Per altre informazioni sul percorso dei 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 del VF. Si tratta dell'indirizzo MAC permanente per la scheda di rete VF esposta nel sistema operativo guest.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC corrente del VF. Si tratta dell'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

La struttura NDIS_NIC_SWITCH_VF_PARAMETERS viene usata nelle richieste del metodo OID di OID_NIC_SWITCH_ALLOCATE_VF e OID_NIC_SWITCH_VF_PARAMETERS.

Per altre informazioni sull'interfaccia SR-IOV, vedere Panoramica di Single Root I/O Virtualization (SR-IOV).