// ndkpi.h
NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;
VOID NdkFnCreateCompletion(
[in, optional] PVOID Context,
[in] NTSTATUS Status,
[in] NDK_OBJECT_HEADER *pNdkObject
)
{...}
View the official Windows Driver Kit DDI reference
No description available.
The NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function completes the creation of an NDK object.
Context
[in, optional]The context value passed to the NDK provider when a consumer calls an object creation function. The creation function provides the context with the asynchronous create completion request NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function pointer.
Status
[in]The asynchronous completion status for the create request. See the object creation functions (for example, NDK_FN_CREATE_CQ) for completion status codes that can be returned for each type of object.
pNdkObject
[in]A pointer to an NDK object header (NDK_OBJECT_HEADER).
Note This function is implemented by the NDK consumer and passed to the NDK provider.
NDK objects are created with asynchronous functions. These asynchronous object creation functions take an NDK_FN_CREATE_COMPLETION function pointer as an input parameter.
An NDK provider can return STATUS_PENDING from an asynchronous object creation function. In this case, the NDK provider must call the create completion function to indicate that the object creation is complete.
Any status other status code indicates inline completion. In this case, the provider must not call the create request completion function. If the create request function returns an NT_STATUS status code other than STATUS_PENDING, the created object must be returned in an output parameter with the create request function.
For create requests that return STATUS_PENDING and later complete with STATUS_SUCCESS asynchronously, the created object must be returned by the create completion function with the pNdkObject parameter and the provider must not access the object output parameter of the create request function.
NDKPI Object Lifetime Requirements