Standardisierte INF-Schlüsselwörter für SR-IOV
In diesem Thema werden die standardisierten INF-Schlüsselwörter für die SR-IOV-Schnittstelle (Single Root E/O Virtualization) beschrieben. Diese Schlüsselwörter gelten für die INF-Datei für den Miniporttreiber der PHYSISCHEn Funktion (PCI Express, PCIe) eines SR-IOV-Netzwerkadapters.
Die SR-IOV INF-Schlüsselwörter werden in den folgenden Abschnitten beschrieben:
Standardisierte INF-Schlüsselwörter für das Aktivieren oder Deaktivieren der SR-IOV-Unterstützung
Standardisierte INF-Schlüsselwörter für die Konfiguration des Standard-NIC-Switches
Standardisierte INF-Schlüsselwörter zum Aktivieren oder Deaktivieren der SR-IOV-Unterstützung
Standardisierte INF-Schlüsselwörter werden definiert, um die Unterstützung für die SR-IOV-Features eines Netzwerkadapters zu aktivieren oder zu deaktivieren.
*SRIOV
Ein -Wert, der beschreibt, ob das Gerät das SR-IOV-Feature aktiviert oder deaktiviert hat.
Nach der Installation des Treibers können Administratoren den Wert *SRIOV Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Netzwerkadapter aktualisieren. Weitere Informationen zu erweiterten Eigenschaften finden Sie unter Angeben von Konfigurationsparametern für die Seite Erweiterte Eigenschaften.
Hinweis Der Miniporttreiber wird automatisch neu gestartet, nachdem eine Änderung auf der Eigenschaftenseite Erweitert für den Adapter vorgenommen wurde.
*SriovPreferred
Ein -Wert, der definiert, ob SR-IOV-Funktionen anstelle von VMQ-Funktionen (VMQ) oder RSS-Funktionen (Receive Side Scaling) aktiviert werden sollen.
Dies ist ein ausgeblendeter Schlüsselwort (keyword) Wert, der nicht in der INF-Datei angegeben werden darf und nicht auf der Eigenschaftenseite Erweitert für den Netzwerkadapter angezeigt wird.
Weitere Informationen zum Interpretieren von SR-IOV-, VMQ- und RSS-Schlüsselwörtern finden Sie unter Handling SR-IOV, VMQ, and RSS Standardized INF Keywords.
Die standardisierten SR-IOV-INF-Schlüsselwörter sind Enumerationsschlüsselwörter und werden in der folgenden Tabelle beschrieben. Die Spalten in dieser Tabelle beschreiben die folgenden Attribute für eine Enumeration Schlüsselwort (keyword):
Name des Unterschlüssels
Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen. Dieser Name wird auch in der Registrierung unter dem Schlüssel NDI\params\ für den Netzwerkadapter angezeigt.
ParamDesc
Der Anzeigetext, der dem subkeyName-Schlüsselwort (keyword) zugeordnet ist.
Hinweis Der unabhängige Hardwarehersteller (Independent Hardware Vendor, IHV) kann jeden beschreibenden Text für den SubkeyName definieren.
Wert
Der ganzzahlige Enumerationswert, der den einzelnen SubkeyName-Schlüsselwort (keyword) in der Liste zugeordnet ist.
EnumDesc
Der Anzeigetext, der jedem Wert zugeordnet ist, der im Menü angezeigt wird.
| Name des Unterschlüssels | ParamDesc | Wert | EnumDesc |
|---|---|---|---|
| *SRIOV | SR-IOV | 0 | Disabled |
| 1 (Standard) | Aktiviert | ||
| *SriovPreferred | Die Einträge ParamDesc und EnumDesc für diesen Unterschlüssel können weder in INF-Dateien noch in einer Benutzeroberfläche verwendet werden. | 0 (Standard) | Melden Sie RSS- oder VMQ-Funktionen basierend auf dem *VmqOrRssPreferrence-Schlüsselwort (keyword). Melden Sie SR-IOV-Funktionen nicht. Weitere Informationen zum *VmqOrRssPreferrence-Schlüsselwort (keyword) finden Sie unter Standardisierte INF-Schlüsselwörter für VMQ. |
| 1 | Sr-IOV-Funktionen melden. |
Weitere Informationen zu standardisierten INF-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.
Standardisierte INF-Schlüsselwörter für die Konfiguration des Standard-NIC-Switches
Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur einen NIC-Switch auf dem Netzwerkadapter. Dieser Switch wird als Standard-NIC-Switch bezeichnet und vom bezeichner NDIS_DEFAULT_SWITCH_ID referenziert.
Die INF-Datei für den PF-Miniporttreiber muss die Konfiguration des Standard-NIC-Switches auf dem SR-IOV-Netzwerkadapter angeben. Dadurch kann das Netzwerkinstallationsprogramm die Standardmäßigen Switchkonfigurationsinformationen aus dem INF in die Miniportregistrierungskonfiguration unter dem Unterschlüssel für den Standardswitch (NDI\params\NicSwitches\0) kopieren.
Diese Schlüsselwörter werden auf der Eigenschaftenseite Erweitert für den Netzwerkadapter nicht angezeigt und können nicht vom Benutzer konfiguriert werden. Diese Schlüsselwörter werden mithilfe der AddReg-Anweisung im Abschnitt DDInstall der INF-Datei angegeben. Jede Schlüsselwort (keyword) wird durch eine separate AddReg-Direktive angegeben.
In der folgenden Tabelle werden die INF-Schlüsselwörter für die Standardkonfiguration des NIC-Switches des SR-IOV-Netzwerkadapters beschrieben. Die Spalten in dieser Tabelle beschreiben die folgenden Attribute für diese Schlüsselwörter:
Name des Unterschlüssels
Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen. Dieser Name wird auch in der Registrierung unter dem Schlüssel NDI\params\NicSwitches\0 für den Netzwerkadapter angezeigt.
Datenwert
Der Wert, der dem subkeyName-Schlüsselwort (keyword) zugeordnet ist.
Datentyp
Der Typ des Datenwerts.
| Name des Unterschlüssels | Datenwert | Datentyp | Notizen |
|---|---|---|---|
| *Flaggen | 0 | REG_DWORD | Der Schlüsselwort (keyword) muss dieser Wert zugewiesen werden. |
| *SwitchType | 1 | REG_DWORD | Der Schlüsselwort (keyword) muss dieser Wert zugewiesen werden. |
| *SwitchId | 0 | REG_DWORD | Der Schlüsselwort (keyword) muss dieser Wert zugewiesen werden. |
| *Switchname | "Standardswitch" | REG_SZ | Der Schlüsselwort (keyword) muss dieser Wert zugewiesen werden. |
| *NumVFs | (0-n), | REG_DWORD | n ist die maximale Anzahl von virtuellen PCIe-Funktionen (VFs), die vom SR-IOV-Netzwerkadapter unterstützt werden. Hinweis Dieser Registrierungsschlüssel definiert die maximale Anzahl von VFs, die vom Netzwerkadapter unterstützt werden. Wenn der Miniporttreiber NdisMSetMiniportAttributes aufruft, kann er je nach verfügbaren Hardwareressourcen auf dem Netzwerkadapter kleiner als diesen Wert ankündigen. Weitere Informationen finden Sie unter Ermitteln der NIC Switch-Funktionen. |
Im Folgenden finden Sie ein Beispiel für AddReg-Anweisungen für die Standardkonfiguration des NIC-Switches eines SR-IOV-Netzwerkadapters:
HKR, NicSwitches\0, *SwitchId, 0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”
Weitere Informationen zur Syntax der AddReg-Direktive finden Sie unter INF AddReg-Direktive.
Weitere Informationen zum Standard-NIC-Switch finden Sie unter NIC-Switches.