struttura NDIS_NIC_SWITCH_VF_PARAMETERS (ntddndis.h)

Articolo
02/07/2025

Il NDIS_NIC_SWITCH_VF_PARAMETERS specifica i parametri di risorsa 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;

Membri

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 Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura di NDIS_NIC_SWITCH_VF_PARAMETERS, il driver deve impostare il membro revision di Header sul valore seguente:

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro dimensioni 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 switch. Questo valore identifica il commutatore della scheda di rete in cui viene allocato il VF.

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 di scheda di rete predefinito.

Nota A partire da Windows Server 2012, l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) 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 interno della Hyper-V partizione figlio 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 Hyper-V partizione figlio 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 vm è un dispositivo virtuale esposto nel sistema operativo guest eseguito in una partizione figlio Hyper-V. La scheda di rete vm viene 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 dati VF, vedere SR-IOV percorso dati VF.

MacAddressLength

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

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC permanente del 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 del 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.

Osservazioni

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

Per altre informazioni sull'interfaccia SR-IOV, vedere Panoramica della virtualizzazione I/O radice singola (SR-IOV).