NDK_FN_CREATE_COMPLETION routine

The NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function completes the creation of an NDK object.

Syntax


NDK_FN_CREATE_COMPLETION NdkCreateCompletion;

VOID NdkCreateCompletion(
  _In_opt_  PVOID Context,
  _In_      NTSTATUS Status,
  _In_      NDK_OBJECT_HEADER *pNdkObject
)
{ ... }

Parameters

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).

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

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Version

Supported in NDIS 6.30 and later.

Header

Ndkpi.h (include Ndkpi.h)

IRQL

<=DISPATCH_LEVEL

See also

NDK_OBJECT_HEADER
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
NDKPI Object Lifetime Requirements

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft