Udostępnij przez


Wymagania dotyczące interfejsu INF dla interfejsu NDKPI

Plik INF dla sterownika miniportu, który obsługuje jądro bezpośrednich sieci (NDK) musi spełniać następujące wymagania.

Górna wartość zakresu NDIS

Plik INF sterownika miniportu musi określić wartość górną zakresu NDIS jako "ndis5", aby składniki systemu Windows mogły odnajdywać i używać adapterów miniportowych z obsługą NDK, które są obsługiwane przez sterownik. Ta wartość jest określona w następujący sposób:

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

*NetworkDirect INF słowo kluczowe

Plik INF musi określić wartość słowa kluczowego *NetworkDirect w następujący sposób:

  • Po zainstalowaniu sterownika administratorzy mogą zaktualizować wartość słowa kluczowego *NetworkDirect w zakładce właściwości Zaawansowane dla karty.

Uwaga: Sterownik miniportu jest automatycznie uruchamiany ponownie po wprowadzeniu zmiany w zakładce właściwości Zaawansowane dla karty.

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 słowo kluczowe INF

Plik INF musi określić wartość słowa kluczowego *NetworkDirectTechnology w następujący sposób:

  • Po zainstalowaniu sterownika administratorzy mogą zaktualizować wartość słowa kluczowego *NetworkDirectTechnology w obszarze Zaawansowane dla karty sieciowej. Wyliczenia wykluczają się wzajemnie, co oznacza, że wybór wartości NetworkDirectTechnology wyklucza wszystkie inne. Dzięki temu platforma może definiować ścisłe zachowanie urządzenia.
  • Urządzenie musi wyrażać tylko obsługiwane transporty. Wartości transportu to identyfikatory mapowane na WDK NDK_RDMA_TECHNOLOGY. Ponowne zdefiniowanie identyfikatorów jest zabronione.
  • Zachowanie urządzeń z wieloma równoczesnymi transportami jest niezdefiniowane. Urządzenie musi określać typ transportu.

Uwaga: Sterownik miniportu automatycznie uruchamia się ponownie po wprowadzeniu zmiany na stronie właściwości Zaawansowane dla karty sieciowej.

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"

*Słowo kluczowe INF NetworkDirectRoCEFrameSize

Plik INF dla sterownika miniportu, który obsługuje *NetworkDirectRoCEFrameSize musi spełniać następujące wymagania:

  • *NetworkDirectRoCEFrameSize to słowo kluczowe, które określa maksymalną jednostkę transmisji (MTU) wymaganą przez administratora dla komunikacji NetworkDirect. Adaptery obsługujące słowo kluczowe *NetworkDirect z RoCE lub RoCEv2 muszą dodatkowo obsługiwać to słowo kluczowe.

  • Dopuszczalne wartości rejestru *NetworkDirectRoCEFrameSize to 256, 512, 1024, 2048 i 4096. Wymagana jest wartość 1024.

  • Adapter musi używać największego obsługiwanego rozmiaru dla *NetworkDirectRoCEFrameSize, który nie przekracza *JumboPacket.

  • Jeśli skonfigurowana wartość *NetworkDirectRoCEFrameSize różni się od operacyjnego (aktywnego) MTU dla RoCE, sterownik musi zarejestrować zdarzenie w dzienniku zdarzeń systemu, wskazujące operacyjne (aktywne) MTU dla RoCE.

Uwaga: sterownik miniportu jest automatycznie uruchamiany ponownie po wprowadzeniu zmiany na stronie właściwości Zaawansowane dla karty, chyba że można wprowadzić zmianę bez ponownego uruchomienia.

W poniższej tabeli opisano słowo kluczowe *NetworkDirectRoCEFrameSize i wartości, które można edytować. Wartości minimalne i maksymalne definiują wymagane limity dla obsługiwanych wartości. Pojedynczy adapter może obsługiwać niższą wartość minimalną lub wyższą wartość maksymalną, ale musi obsługiwać co najmniej te wartości.

Nazwa podklucza ParamDesc Typ Wartość domyślna Minuta Maks
*NetworkDirectRoCEFrameSize Maksymalna jednostka transmisyjna Network Direct wyliczenie 1024 256 4096

Aby uzyskać więcej informacji na temat właściwości zaawansowanych, zobacz Określanie parametrów konfiguracji dla strony właściwości zaawansowanych.

Aby uzyskać więcej informacji na temat używania ustandaryzowanych słów kluczowych INF, zobacz Ustandaryzowane słowa kluczowe INF dla urządzeń sieciowych.

Interfejs jądra dostawcy sieciowego bezpośredniego (NDKPI - Network Direct Kernel Provider Interface)