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

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.

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

See also

NDKPI Object Lifetime Requirements

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