通过

NDKPI 的 INF 要求

  • 项目

支持网络直接内核 (NDK) 的微型端口驱动程序的 INF 文件必须满足以下要求。

NDIS 上限范围值

微型端口驱动程序的 INF 文件必须指定 NDIS 上限范围值“ndis5”，以便 Windows 组件发现并使用由驱动程序提供服务的支持 NDK 的微型端口适配器。 此值的指定方式如下：

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

*NetworkDirect INF 关键字 (keyword)

INF 文件必须指定 *NetworkDirect 关键字 (keyword) 值，如下所示：

  • 安装驱动程序后，管理员可以更新适配器的“高级”属性页中的*NetworkDirect 关键字 (keyword) 值。

注意：在适配器的“ 高级 ”属性页中进行更改后，微型端口驱动程序会自动重启。

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 关键字 (keyword)

INF 文件必须指定 *NetworkDirectTechnology 关键字 (keyword) 值，如下所示：

  • 安装驱动程序后，管理员可以更新适配器的“高级”属性页中的 *NetworkDirectTechnology 关键字 (keyword) 值。 枚举是互斥的，这意味着选择 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 关键字 (keyword)

支持 NetworkDirectRoCEFrameSize 的微型端口驱动程序的 INF 文件必须满足以下要求：

  • *NetworkDirectRoCEFrameSize 关键字 (keyword) 指定管理员为 NetworkDirect 通信请求的最大传输单位。 支持使用 RoCE 或 RoCEv2 的 NetworkDirect 关键字 (keyword) 的适配器必须另外支持此关键字 (keyword) 。

  • *NetworkDirectRoCEFrameSize 可接受的注册表值为 256、512、1024、2048 和 4096。 值 1024 是必需的。

  • 适配器必须使用不超过 *JumboPacket 的 *NetworkDirectRoCEFrameSize 支持的最大大小。

  • 如果配置的 NetworkDirectRoCEFrameSize 值不同于 RoCE MTU) 活动操作 (，则驱动程序必须在系统事件日志中记录一个事件，该事件指示操作 (活动) RoCE MTU。

注意：在适配器的 “高级 ”属性页中进行更改后，微型端口驱动程序会自动重启，除非无需重启即可使更改生效。

下表描述了 *NetworkDirectRoCEFrameSize 关键字 (keyword) 和可以编辑的值。 最小值和最大值定义受支持值所需的限制。 单个适配器可以支持较低的最小值或更高的最大值，但必须至少支持这些值。

SubkeyName ParamDesc 类型 默认值 Min Max
*NetworkDirectRoCEFrameSize 网络直接最大传输单位 枚举 1024 256 4096

有关高级属性的详细信息，请参阅 为高级属性页指定配置参数。

有关使用标准化 INF 关键字的详细信息，请参阅 网络设备的标准化 INF 关键字。

网络直接内核提供程序接口 (NDKPI)