Parole chiave INF standardizzate per SR-IOV

In questo argomento vengono descritte le parole chiave INF standardizzate per l'interfaccia di virtualizzazione di I/O radice singola (SR-IOV). Queste parole chiave si applicano al file INF per il driver miniport della funzione fisica PCI Express (PCIe) di una scheda di rete SR-IOV.

Le parole chiave INF SR-IOV sono descritte nelle sezioni seguenti:

parole chiave INF standardizzate per l'abilitazione o la disabilitazione SR-IOV supporto

parole chiave INF standardizzate per la configurazione del commutatore NIC predefinito

Parole chiave INF standardizzate per l'abilitazione o la disabilitazione del supporto SR-IOV

Le parole chiave INF standardizzate vengono definite per abilitare o disabilitare il supporto per le funzionalità SR-IOV di una scheda di rete.

*SRIOV
Valore che descrive se il dispositivo ha abilitato o disabilitato la funzionalità di SR-IOV.

Dopo aver installato il driver, gli amministratori possono aggiornare il valore della parola chiave *SRIOV nella pagina delle proprietà avanzate per la scheda di rete. Per altre informazioni sulle proprietà avanzate, vedere Specificare i parametri di configurazione per la pagina delle Proprietà avanzate.

Nota Il driver miniport viene riavviato automaticamente dopo che è stata apportata una modifica nella pagina delle proprietà avanzate di per l'adattatore.

*SriovPreferred
Valore che definisce se le funzionalità di SR-IOV devono essere abilitate invece delle funzionalità VMQ (Virtual Machine Queue) o di ridimensionamento lato ricezione (RSS).

Si tratta di un valore di parola chiave nascosto che non deve essere specificato nel file INF e non viene visualizzato in pagina delle proprietà Avanzate per la scheda di rete.

Per altre informazioni su come interpretare le parole chiave SR-IOV, VMQ e RSS, vedere Handling SR-IOV, VMQ e RSS Standardized INF Keywords.

Le parole chiave INF standardizzate SR-IOV sono parole chiave di enumerazione e sono descritte nella tabella seguente. Le colonne di questa tabella descrivono gli attributi seguenti per una parola chiave di enumerazione:

SubkeyName
Nome della parola chiave che è necessario specificare nel file INF. Questo nome viene visualizzato anche nel Registro di sistema nella chiave NDI\params\ per la scheda di rete.

ParamDesc
Testo visualizzato associato alla parola chiave SubkeyName.

Nota Il fornitore di hardware indipendente (IHV) può definire qualsiasi testo descrittivo per SubkeyName.

Valore
Valore intero di enumerazione associato a ciascuna parola chiave SubkeyName nell'elenco.

EnumDesc
Testo visualizzato associato a ogni valore visualizzato nel menu.

SubkeyName	ParamDesc	Valore	EnumDesc
*SRIOV	SR-IOV	0	Disabile
		1 (impostazione predefinita)	Abilitato
*SriovPreferred	Le voci ParamDesc ed EnumDesc per questa sottochiave non possono essere usate nei file INF o in un'interfaccia utente.	0 (impostazione predefinita)	Creare report sulle funzionalità RSS o VMQ basate sulla parola chiave *VmqOrRssPreferrence. Non segnalare le capacità SR-IOV. Per ulteriori informazioni sulla parola chiave *VmqOrRssPreferrence, vedere parole chiave standard INF per VMQ.
		1	Funzionalità di report SR-IOV.

Per altre informazioni sulle parole chiave INF standardizzate, vedere parole chiave INF standardizzate per i dispositivi di rete.

Parole chiave INF standardizzate per la configurazione dell'opzione NIC predefinita

A partire da Windows Server 2012, l'interfaccia SR-IOV supporta un solo commutatore NIC sulla scheda di rete. Questa opzione è nota come opzione di interfaccia di rete predefinita e fa riferimento all'identificatore NDIS_DEFAULT_SWITCH_ID.

Il file INF per il driver miniport PF deve specificare la configurazione del commutatore NIC predefinito sull'adattatore di rete SR-IOV. In questo modo il programma di installazione di rete può copiare le informazioni di configurazione dell'interruttore predefinito dall'INF alla configurazione del Registro di sistema della miniporta nella sottochiave per l'interruttore predefinito (NDI\params\NicSwitches\0).

Queste parole chiave non vengono visualizzate nella scheda delle proprietà Avanzate per l'adattatore di rete e non possono essere configurate dall'utente. Queste parole chiave vengono specificate usando la direttiva AddReg nella sezione DDInstall del file INF. Ogni parola chiave viene specificata da una direttiva separata AddReg.

Nella tabella seguente vengono descritte le parole chiave INF per la configurazione predefinita del commutatore NIC della scheda di rete SR-IOV. Le colonne di questa tabella descrivono gli attributi seguenti per queste parole chiave:

SubkeyName
Nome della parola chiave che è necessario specificare nel file INF. Questo nome viene visualizzato anche nel Registro di sistema nella chiave di NDI\params\NicSwitches\0 per la scheda di rete.

Valore del dato
Valore associato alla parola chiave SubkeyName.

Tipo di dati
Tipo del valore di dati.

SubkeyName	Valore dei dati	Tipo di dati	Note
*Bandiere	0	REG_DWORD	A questo valore deve essere assegnata la parola chiave .
*SwitchType	1	REG_DWORD	A questo valore deve essere assegnata la parola chiave .
*SwitchId	0	REG_DWORD	A questo valore deve essere assegnata la parola chiave .
*SwitchName	"Interruttore predefinito"	REG_SZ	A questo valore deve essere assegnata la parola chiave .
*NumVFs	(0-n),	REG_DWORD	n è il numero massimo di funzioni virtuali PCIe supportate dalla scheda di rete SR-IOV. Nota Questa chiave del Registro di sistema definisce il numero massimo di VFS supportate dalla scheda di rete. Quando il driver miniport chiama NdisMSetMiniportAttributes, può annunciare meno di questo valore in base alle risorse hardware disponibili sulla scheda di rete. Per ulteriori informazioni, consultare Determinazione delle funzionalità del commutatore NIC.

Di seguito è riportato un esempio di direttive AddReg per la configurazione predefinita del commutatore NIC di una scheda di rete SR-IOV:

HKR, NicSwitches\0, *SwitchId,   0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”

Per ulteriori informazioni sulla sintassi della direttiva AddReg, vedere direttiva AddReg INF.

Per ulteriori informazioni sul commutatore NIC predefinito, vedere Commutatori di scheda di interfaccia di rete.