NDKPI の INF 要件

  • [アーティクル]

ネットワーク ダイレクト カーネル (NDK) をサポートするミニポート ドライバーの INF ファイルは、次の要件を満たす必要があります。

NDIS の上限範囲の値

ミニポート ドライバーの INF ファイルは、ドライバーによって処理される NDK 対応ミニポート アダプターを検出して使用する Windows コンポーネントの NDIS 上限の値 "ndis5" を指定する必要があります。 この値は、次のように指定されます。

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

*NetworkDirect INF キーワード

INF ファイルでは、次のように *NetworkDirect キーワード値を指定する必要があります。

  • ドライバーがインストールされると、管理者は、アダプターの「詳細」プロパティ ページの *NetworkDirect キーワード値を更新できます。

注: ミニポート ドライバーは、アダプターの「詳細」プロパティ ページで変更が行われた後に自動的に再起動されます。

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 キーワード

INF ファイルでは、次のように *NetworkDirectTechnology キーワード値を指定する必要があります。

  • ドライバーがインストールされると、管理者は、アダプターの「詳細」プロパティ ページの *NetworkDirectTechnology キーワード値を更新できます。 リストは相互に排他的です。つまり、NetworkDirectTechnology 値を選択すると、他のすべての値が除外されます。 これにより、プラットフォームで厳密なデバイス動作を定義できます。
  • デバイスは、サポートされているトランスポートのみを表す必要があります。 トランスポート値は、WDK NDK_RDMA_TECHNOLOGY にマップされる識別子です。 識別子の再定義は禁止されています。
  • 複数の同時トランスポートを持つデバイスの動作は未定義です。 デバイスはトランスポートの種類を指定する必要があります 。

注: ミニポート ドライバーは、アダプターの「詳細」プロパティ ページで変更が行われた後に自動的に再起動されます。

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 キーワード

*NetworkDirectRoCEFrameSize をサポートするミニポート ドライバーの INF ファイルは、次の要件を満たす必要があります。

  • *NetworkDirectRoCEFrameSize キーワード は、NetworkDirect 通信に対して管理者が要求した最大伝送単位を指定します。 RoCE または RoCEv2 を使用する *NetworkDirect キーワード をサポートするアダプターは、このキーワードをさらにサポートする必要があります。

  • *NetworkDirectRoCEFrameSize の許容されるレジストリ値は、256、512、1024、2048、4096 です。 1024 の値が必要です。

  • アダプターは、*JumboPacket を超えない *NetworkDirectRoCEFrameSize でサポートされている最大サイズを使用する必要があります。

  • *NetworkDirectRoCEFrameSize の構成値が運用 (アクティブ) RoCE MTU と異なる場合、ドライバーは、運用 (アクティブ) RoCE MTU を示すイベントをシステム イベント ログに記録する必要があります。

注: ミニポート ドライバーは、変更が再起動なしで有効になる場合を除き、アダプターの「詳細」プロパティ ページで変更が行われた後に自動的に再起動されます。

次の表では、*NetworkDirectRoCEFrameSize キーワードと編集できる値について説明します。 最小値と最大値は、サポートされている値に必要な制限を定義します。 個々のアダプターは、より小さい最小値またはより大きい最大値をサポートできますが、少なくともこれらの値をサポートする必要があります。

SubkeyName ParamDesc Type 規定値 Min Max
*NetworkDirectRoCEFrameSize ネットワークダイレクト最大伝送単位 enum 1024 256 4096

詳細プロパティの詳細は、「詳細プロパティ ページの構成パラメーターの指定」を参照してください。

標準化された INF キーワード の詳細については、「ネットワークデバイスの標準化された INF キーワード」を参照してください。

Network Direct Kernel Provider Interface (NDKPI)