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)的指针。
返回值
没有
言论
Note This function is implemented by the NDK consumer and passed to the NDK provider.
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 |