NDK_FN_CLOSE_COMPLETION callback function (ndkpi.h)

The NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) function is an asynchronous completion function for closing NDK objects.

Syntax

NDK_FN_CLOSE_COMPLETION NdkFnCloseCompletion;

void NdkFnCloseCompletion(
  [in, optional] PVOID Context
)
{...}

Parameters

[in, optional] Context

A context value for each close request that is passed to the provider with the asynchronous close request function (NDK_FN_CLOSE_COMPLETION) pointer.

Return value

None

Remarks

NDK close requests can return either STATUS_SUCCESS or STATUS_PENDING. That is, a close request can never fail, but can be completed asynchronously at a later time. The provider must call the NdkCloseCompletion function if NdkCloseObject returns STATUS_PENDING. The provider must not call the NdkCloseCompletion function if the NdkCloseCompletion function returns any status other than STATUS_PENDING.

A close request will remain pending while there is another pending request or an in-progress notification callback on the object being closed.

The provider will call the NdkCloseCompletion function after all pending requests have been completed for the object (that is, the provider called the associated completion function for a request and the completion function returned control back to the provider) and all in-progress notification callbacks have returned control back to the provider.

Requirements

See also

NDKPI Object Lifetime Requirements

NDK_FN_CLOSE_OBJECT

NDK_OBJECT_HEADER

NDK_OBJECT_TYPE