NDK_FN_INITIALIZE_FAST_REGISTER_MR回调函数 (ndkpi.h)

  • 项目

NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) 函数 (MR) 初始化 NDK 内存区域，以便快速注册。

语法

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

参数

[in] pNdkMr

指向 NDK 内存区域的指针 (MR) 对象 (NDK_MR) 。

[in] AdapterPageCount

要在此 MR 中支持的最大适配器页数，以便支持使用相同或较少数量的适配器页快速注册工作请求。

[in] RemoteAccess

一个 BOOLEAN 值，该值指示是否必须初始化 MR 才能进行远程访问。 如果使用者将使用 NdkFastRegister (NDK_FN_FAST_REGISTER) 函数请求远程访问，则 NDK 使用者必须将 RemoteAccess 设置为 TRUE。

[in] RequestCompletion

指向请求完成回调例程 NdkRequestCompletion 的指针 (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

要传递给 RequestCompletion 参数中指定的回调函数的 Context 参数的上下文值。

返回值

The
NdkInitializeFastRegisterMr 函数返回以下 NTSTATUS 代码之一。

返回代码 说明
STATUS_SUCCESS
 初始化已成功完成。
STATUS_PENDING
 操作处于挂起状态，稍后将完成。 驱动程序将调用指定的 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 函数来完成挂起的操作。
STATUS_IMPLEMENTATION_LIMIT
 请求失败，因为适配器不支持请求的 AdapterPageCount。
其他状态代码
 出现了错误。

注解

NdkInitializeFastRegisterMr 初始化 MR 以快速注册。 必须使用 NdkCreateMr (的 FastRegister 参数创建NDK_MR对象NDK_FN_CREATE_MR) 函数设置为 TRUE。

可以并行或一个接一个地对 NdkInitializeFastRegisterMr 进行多次调用。

NdkInitializeFastRegisterMr 返回后，可将快速注册工作请求发布到队列对 (QP) 。

要求

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

另请参阅

NDKPI 对象生存期要求

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR