NDK_FN_INVALIDATE回调函数（ndkpi.h）

项目
02/07/2025

NdkInvalidate（NDK_FN_INVALIDATE）函数使快速寄存器 NDK 内存区域（MR）或内存窗口（兆瓦）失效。

语法

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

参数

[in] pNdkQp

指向 NDK 队列对（QP）对象的指针（NDK_QP）。

[in, optional] RequestContext

要在此请求 NDK_RESULT 结构的 RequestContext 成员中返回的上下文值。

[in] pNdkMrOrMw

指向内存区域（MR）对象（NDK_MR）或内存（兆瓦）对象（NDK_MW）的指针，该对象是在 NDK_OBJECT_HEADER 结构中指定的。如果指定了 MR 对象，则必须向 NdkFastRegister （NDK_FN_FAST_REGISTER）函数注册 MR 对象。 NDK 使用者绝不能指定在 pNdkMrOrMw 参数中向 NdkRegister （NDK_FN_REGISTER）函数注册的 MR 对象。可以使用 NdkDeregisterMr （NDK_FN_DEREGISTER_MR）函数删除向 NdkRegister（NDK_FN_REGISTER）函数注册的 MR 对象的访问权限。

[in] Flags

指定允许的作的按位 OR 标志。支持以下标志：

价值	意义
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	指示此请求成功完成不会在出站完成队列中生成完成事件。但是，失败的请求会在完成队列中生成事件。
NDK_OP_FLAG_READ_FENCE 0x00000002	指示在硬件开始处理此请求之前，必须先完成所有以前的读取请求。
NDK_OP_FLAG_DEFER 0x00000200	向 NDK 提供程序指示它可能会延迟向硬件请求进行处理。有关此标志的详细信息，请参阅 NDKPI 延迟处理方案。注意此标志仅在 NDKPI 1.2（Windows Server 2012 R2）及更高版本中受支持。

返回值

这
NdkInvalidate 函数返回以下 NTSTATUS 代码之一。

返回代码	描述
STATUS_SUCCESS	请求已成功发布。完成工作请求完成后，完成项将排队到 CQ。
STATUS_CONNECTION_INVALID	QP 未连接。
其他状态代码	发生错误。

言论

NdkInvalidate 使 NDK 快速寄存器 MR 或MW 失效。

要求

要求	价值
最低支持的客户端	NDIS 6.30 及更高版本不支持。
支持的最低服务器	Windows Server 2012
目标平台	窗户
标头	ndkpi.h （包括 Ndkpi.h）
IRQL	<=DISPATCH_LEVEL