Parole chiave INF standardizzate per SR-IOV
In questo argomento vengono descritte le parole chiave INF standardizzate per l'interfaccia di virtualizzazione 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 SR-IOV INF sono descritte nelle sezioni seguenti:
Parole chiave INF standardizzate per l'abilitazione o la disabilitazione del supporto SR-IOV
Parole chiave INF standardizzate per l'abilitazione o la disabilitazione del supporto SR-IOV
Le parole chiave INF standardizzate sono 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à 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 Specifica dei parametri di configurazione per la pagina Proprietà avanzate.
Nota Il driver miniport viene riavviato automaticamente dopo aver apportato una modifica nella pagina delle proprietà Avanzate per l'adattatore.
*SriovPreferred
Valore che definisce se le funzionalità SR-IOV devono essere abilitate anziché la coda di macchine virtuali (VMQ) o le funzionalità rss (Side Scaling).
Si tratta di un valore di parola chiave nascosto che non deve essere specificato nel file INF e non viene visualizzato nella pagina delle proprietà Avanzate per la scheda di rete.
Per altre informazioni su come interpretare le parole chiave SR-IOV, VMQ e RSS, vedere Gestione delle parole chiave SR-IOV, VMQ e RSS Standardized INF.
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 sotto la chiave NDI\params\ per la scheda di rete.
ParamDesc
Testo visualizzato associato alla parola chiave SubkeyName .
Nota Il fornitore hardware indipendente (IHV) può definire qualsiasi testo descrittivo per SubkeyName.
Valore
Valore intero dell'enumerazione associato a ogni parola chiave SubkeyName nell'elenco.
EnumDesc
Testo visualizzato associato a ogni valore visualizzato nel menu.
| SubkeyName | ParamDesc | Valore | EnumDesc |
|---|---|---|---|
| *SRIOV | SR-IOV | 0 | Disabled |
| 1 (impostazione predefinita) | Attivato | ||
| *SriovPreferred | Le voci ParamDesc ed EnumDesc per questa sottochiave non possono essere usate nei file INF o in un'interfaccia utente. | 0 (predefinito) | Creare report sulle funzionalità RSS o VMQ basate sulla parola chiave *VmqOrRssPreferrence . Non segnalare le funzionalità SR-IOV. Per altre informazioni sulla parola chiave *VmqOrRssPreferrence , vedere Parole chiave INF standardizzate per VMQ. |
| 1 | Segnalare le funzionalità 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 di interfaccia di rete predefinita
A partire da Windows Server 2012, l'interfaccia SR-IOV supporta un solo commutatore di scheda di interfaccia di rete 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 di interfaccia di rete predefinito sulla scheda di rete SR-IOV. Ciò consente al programma di installazione di rete di copiare le informazioni di configurazione del commutatore predefinite da INF alla configurazione del Registro di sistema miniport sotto la sottochiave per l'opzione predefinita (NDI\params\NicSwitches\0).
Queste parole chiave non vengono visualizzate nella pagina delle proprietà Avanzate per la scheda 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 AddReg separata.
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 sotto la chiave NDI\params\NicSwitches\0 per la scheda di rete.
Valore dei dati
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 | "Opzione predefinita" | 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 a seconda delle risorse hardware disponibili nella scheda di rete. Per altre informazioni, vedere Determinazione delle funzionalità del commutatore di scheda di interfaccia di rete. |
Di seguito è riportato un esempio di direttive AddReg per la configurazione predefinita del commutatore di interfaccia di rete di una scheda di rete SR-IOV:
HKR, NicSwitches\0, *SwitchId, 0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”
Per altre informazioni sulla sintassi della direttiva AddReg , vedere Direttiva INF AddReg.
Per altre informazioni sull'opzione di interfaccia di rete predefinita, vedere Commutatori di scheda di interfaccia di rete.