NDK_FN_CREATE_COMPLETION回调函数 (ndkpi.h)

项目
08/07/2023

NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 函数完成 NDK 对象的创建。

语法

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

参数

[in, optional] Context

使用者调用对象创建函数时传递给 NDK 提供程序的上下文值。创建函数为上下文提供异步创建完成请求 NdkCreateCompletion () 函数指针 NDK_FN_CREATE_COMPLETION 。

[in] Status

创建请求的异步完成状态。例如，请参阅对象创建函数 (，NDK_FN_CREATE_CQ) ，了解可针对每种对象类型返回的完成状态代码。

[in] pNdkObject

指向 NDK 对象标头的指针 (NDK_OBJECT_HEADER) 。

返回值

无

备注

注意此函数由 NDK 使用者实现，并传递给 NDK 提供程序。

NDK 对象是使用异步函数创建的。这些异步对象创建函数采用 NDK_FN_CREATE_COMPLETION 函数指针作为输入参数。

NDK 提供程序可以从异步对象创建函数返回STATUS_PENDING。在这种情况下，NDK 提供程序必须调用 create 完成函数以指示对象创建已完成。

其他状态代码的任何状态都指示内联完成。在这种情况下，提供程序不得调用创建请求完成函数。如果 create 请求函数返回除 STATUS_PENDING 以外的NT_STATUS状态代码，则必须使用 create 请求函数在输出参数中返回所创建的对象。

对于返回STATUS_PENDING且稍后使用STATUS_SUCCESS异步完成的创建请求，创建的对象必须由具有 pNdkObject 参数的 create completion 函数返回，并且提供程序不得访问 create 请求函数的对象输出参数。

要求

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