INF-Anforderungen für NDKPI

  • Artikel

Die INF-Datei für einen Miniporttreiber, der NDK (Network Direct Kernel) unterstützt, muss die folgenden Anforderungen erfüllen.

Wert des oberen NDIS-Bereichs

In der INF-Datei des Miniporttreibers muss der obere NDIS-Wert "ndis5" angegeben werden, damit Windows-Komponenten die vom Treiber gewarteten NDK-fähigen Miniportadapter ermitteln und verwenden können. Dieser Wert wird wie folgt angegeben:

HKR, Ndi\Interfaces, UpperRange, 0, "ndis5"

*NetworkDirect INF Schlüsselwort (keyword)

Die INF-Datei muss den Wert *NetworkDirect Schlüsselwort (keyword) wie folgt angeben:

  • Nach der Installation des Treibers können Administratoren den Wert *NetworkDirect Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Adapter aktualisieren.

Hinweis: Der Miniporttreiber wird automatisch neu gestartet, nachdem eine Änderung auf der Eigenschaftenseite Erweitert für den Adapter vorgenommen wurde.

HKR, Ndi\Params\*NetworkDirect,        ParamDesc,  0, "NetworkDirect Functionality"
HKR, Ndi\Params\*NetworkDirect,        Type,       0, "enum"
HKR, Ndi\Params\*NetworkDirect,        Default,    0, "1"
HKR, Ndi\Params\*NetworkDirect\enum,   "0",        0, "Disabled"
HKR, Ndi\Params\*NetworkDirect\enum,   "1",        0, "Enabled"

*NetworkDirectTechnology INF Schlüsselwort (keyword)

Die INF-Datei muss den Wert *NetworkDirectTechnology Schlüsselwort (keyword) wie folgt angeben:

  • Nach der Installation des Treibers können Administratoren den Wert *NetworkDirectTechnology Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Adapter aktualisieren. Die Enumerationen schließen sich gegenseitig aus, d. h. die Auswahl eines NetworkDirectTechnology-Werts schließt alle anderen aus. Dadurch kann die Plattform ein striktes Geräteverhalten definieren.
  • Ein Gerät darf nur die unterstützten Transporte ausdrücken. Die Transportwerte sind Bezeichner, die WDK-NDK_RDMA_TECHNOLOGY zugeordnet werden. Eine Neudefinition der Bezeichner ist unzulässig.
  • Das Verhalten von Geräten mit mehreren gleichzeitigen Transporten ist nicht definiert. Das Gerät muss einen Transporttyp angeben.

Hinweis: Der Miniporttreiber wird automatisch neu gestartet, nachdem eine Änderung auf der Eigenschaftenseite Erweitert für den Adapter vorgenommen wurde.

HKR, Ndi\Params\*NetworkDirectTechnology,        ParamDesc,  0,  "NetworkDirect Technology"
HKR, Ndi\Params\*NetworkDirectTechnology,        Default,    0,  "1"
HKR, Ndi\Params\*NetworkDirectTechnology,        Type,       0,  "enum"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   1,          0,  "iWARP"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   2,          0,  "InfiniBand"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   3,          0,  "RoCE"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   4,          0,  "RoCEv2"
HKR, Ndi\Params\*NetworkDirectTechnology,        Optional,   0,  "0"

*NetworkDirectRoCEFrameSize INF Schlüsselwort (keyword)

Die INF-Datei für einen Miniporttreiber, der *NetworkDirectRoCEFrameSize unterstützt, muss die folgenden Anforderungen erfüllen:

  • Die *NetworkDirectRoCEFrameSize-Schlüsselwort (keyword) gibt die vom Administrator angeforderte maximale Übertragungseinheit für die NetworkDirect-Kommunikation an. Adapter, die die *NetworkDirect-Schlüsselwort (keyword) mit RoCE oder RoCEv2 unterstützen, müssen diese Schlüsselwort (keyword) zusätzlich unterstützen.

  • Die zulässigen Registrierungswerte für *NetworkDirectRoCEFrameSize sind 256, 512, 1024, 2048 und 4096. Der Wert 1024 ist erforderlich.

  • Der Adapter muss die größte unterstützte Größe für *NetworkDirectRoCEFrameSize verwenden, die *JumboPacket nicht überschreitet.

  • Wenn sich der konfigurierte Wert von *NetworkDirectRoCEFrameSize von der operativen (aktiven) RoCE-MTU unterscheidet, muss der Treiber ein Ereignis im Systemereignisprotokoll protokollieren, das die operative (aktive) RoCE-MTU angibt.

Hinweis: Der Miniporttreiber wird automatisch neu gestartet, nachdem eine Änderung auf der Eigenschaftenseite Erweitert für den Adapter vorgenommen wurde, es sei denn, die Änderung kann ohne den Neustart wirksam werden.

In der folgenden Tabelle werden die *NetworkDirectRoCEFrameSize-Schlüsselwort (keyword) und die Werte beschrieben, die bearbeitet werden können. Die min- und max-Werte definieren die erforderlichen Grenzwerte für unterstützte Werte. Ein einzelner Adapter kann einen niedrigeren Mindestwert oder einen höheren Höchstwert unterstützen, muss aber mindestens diese Werte unterstützen.

Name des Unterschlüssels ParamDesc type Standardwert Min Max
*NetworkDirectRoCEFrameSize Maximale Netzwerkübertragungseinheit enum 1024 256 4096

Weitere Informationen zu erweiterten Eigenschaften finden Sie unter Angeben von Konfigurationsparametern für die Seite Erweiterte Eigenschaften.

Weitere Informationen zur Verwendung standardisierter INF-Schlüsselwörter finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.

Network Direct Kernel Provider Interface (NDKPI)