WorkCallback callback function

Applications implement this callback if they call the SubmitThreadpoolWork function to start a worker thread for the work object.

The PTP_WORK_CALLBACK type defines a pointer to this callback function. WorkCallback is a placeholder for the application-defined function name.

Syntax

VOID CALLBACK WorkCallback(
  _Inout_     PTP_CALLBACK_INSTANCE Instance,
  _Inout_opt_ PVOID                 Context,
  _Inout_     PTP_WORK              Work
);

Parameters

• Instance [in, out]
  A TP_CALLBACK_INSTANCE structure that defines the callback instance. Applications do not modify the members of this structure.

  This structure can be passed to one of the following functions:

  • SetEventWhenCallbackReturns
  • ReleaseSemaphoreWhenCallbackReturns
  • LeaveCriticalSectionWhenCallbackReturns
  • ReleaseMutexWhenCallbackReturns
  • FreeLibraryWhenCallbackReturns
  • CallbackMayRunLong
  • DisassociateCurrentThreadFromCallback

• Context [in, out, optional]
  The application-defined data.

• Work [in, out]
  A TP_WORK structure that defines the work object that generated the callback.

Return value

This function does not return a value.

Requirements

Minimum supported client	Windows Vista [desktop apps | UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps | UWP apps]
Header	WinBase.h on Windows Vista, Windows 7, Windows Server 2008 and Windows Server 2008 R2 (include Windows.h); Threadpoolapiset.h on Windows 8 and Windows Server 2012

See also

SubmitThreadpoolWork