NDK_FN_CLOSE_COMPLETION callback function

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

Syntax


NDK_FN_CLOSE_COMPLETION NdkCloseCompletion;

VOID NdkCloseCompletion(
  _In_opt_ PVOID Context
)
{ ... }

Parameters

Context [in, optional]

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

Note  This function is implemented by the NDK consumer and passed to the NDK provider.
 

The NDK programming interface includes an NdkCloseObject (NDK_FN_CLOSE_OBJECT) function for NDK objects. For more information about NDK objects, see NDK_OBJECT_HEADER and NDK_OBJECT_TYPE.

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

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

 

 

Send comments about this topic to Microsoft

Show: