NDK_FN_CREATE_COMPLETION callback function (ndkpi.h)
The NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function completes the creation of an NDK object.
Syntax
NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;
void NdkFnCreateCompletion(
[in, optional] PVOID Context,
[in] NTSTATUS Status,
[in] NDK_OBJECT_HEADER *pNdkObject
)
{...}
Parameters
[in, optional] Context
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.
[in] Status
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.
[in] pNdkObject
A pointer to an NDK object header (NDK_OBJECT_HEADER).
Return value
None
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported,Supported in NDIS 6.30 and later. |
| Minimum supported server | Windows Server 2012 |
| Target Platform | Windows |
| Header | ndkpi.h (include Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |