NDK_FN_CREATE_COMPLETION回调函数 (ndkpi.h)

NdkCreateCompletionNDK_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 提供程序的上下文值。 创建函数为上下文提供异步创建完成请求,NdkCreateCompletionNDK_FN_CREATE_COMPLETION) 函数指针。

[in] Status

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

[in] pNdkObject

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

返回值

没有

言论

Note This function is implemented by the NDK consumer and passed to the NDK provider.
 
使用异步函数创建 NDK 对象。 这些异步对象创建函数采用 NDK_FN_CREATE_COMPLETION 函数指针作为输入参数。

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

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

对于返回STATUS_PENDING和以后异步完成STATUS_SUCCESS的创建请求,必须使用 pNdkObject 参数的创建完成函数返回创建对象,并且提供程序不能访问 create 请求函数的对象输出参数。

要求

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

另请参阅

NDKPI 对象生存期要求

NDK_FN_CREATE_CONNECTOR

NDK_FN_CREATE_CQ

NDK_FN_CREATE_LISTENER

NDK_FN_CREATE_MR

NDK_FN_CREATE_MW

NDK_FN_CREATE_PD

NDK_FN_CREATE_QP

NDK_FN_CREATE_QP_WITH_SRQ

NDK_FN_CREATE_SHARED_ENDPOINT

NDK_FN_CREATE_SRQ

NDK_OBJECT_HEADER