L_SetStatusCallBack

#include "l_bitmap.h"

L_LTKRN_API L_VOID L_SetStatusCallBack(pfnCallback, pUserData, pfnOldCallback, ppOldUserData)

STATUSCALLBACK pfnCallback;	/* pointer to your callback function */
L_VOID* pUserData;	/* pointer to more parameters for the callback */
STATUSCALLBACK* pfnOldCallback;	/* pointer to old callback function */
L_VOID** ppOldUserData;	/* pointer to more parameters for the old callback */

Sets the new status callback function and gets the old status callback.

Parameter	Description
pfnCallback	Pointer to your callback function. The callback function must adhere to the function syntax specified in STATUSCALLBACK Function.
	This callback function must return SUCCESS if the operation was successfully done, or any error if the function call was a failure. If the callback function returns a failure, the current function will terminate and return the same error that the callback returned.
pUserData	Void pointer that you can use to pass one or more additional parameters that the callback function needs.
	To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then, in this parameter, pass the address of the variable or structure, casting it to L_VOID . The callback function, which receives the address in its own pUserData* parameter, can cast it to a pointer of the appropriate data type to access your variable or structure.
	If the additional parameters are not needed, you can pass NULL in this parameter.
pfnOldCallback	Pointer to a variable which will be updated with the old status callback function
ppOldUserData	Pointer to a variable which will be updated with the user data for the old status callback function

Returns

None.

Comments

The status callback is returned through a parameter. You used to have to call L_GetStatusCallBack to get the user data prior to calling L_SetStatusCallback. Now you can get the old callback and set the new callback in one function call.

You can use this function to specify a callback for any of the following functions:

L_AddBitmapNoise
L_AverageFilterBitmap
L_BinaryFilterBitmap
L_ChangeBitmapContrast
L_ChangeBitmapHue
L_ChangeBitmapIntensity
L_ChangeBitmapSaturation
L_ClearBitmap
L_ColorMergeBitmap
L_ColorSeparateBitmap
L_CombineBitmap
L_DeskewBitmap
L_DeskewCheckBitmap
L_DespeckleBitmap
L_EmbossBitmap
L_FillBitmap
L_FlipBitmap
L_GammaCorrectBitmap
L_GetBitmapHistogram
L_GrayScaleBitmap
L_HalfToneBitmap
L_HistoEqualizeBitmap
L_IntensityDetectBitmap
L_InvertBitmap
L_MedianFilterBitmap
L_MMConvertFromBitmapList(Video Module only)
L_MMSaveFile(Video Module only)
L_MosaicBitmap
L_PaintDCEffect
L_PosterizeBitmap
L_PrintBitmap
L_RemapBitmapIntensity
L_ResizeBitmap
L_ReverseBitmap
L_RotateBitmap
L_SharpenBitmap
L_ShearBitmap
L_SizeBitmap
L_SpatialFilterBitmap
L_StretchBitmapIntensity
L_UnderlayBitmap

Both the old status callback function and the user data required for the old status callback function are updated in the pfnOldCallbaclk and ppOldUserData parameters, respectively.

1.	Call the L_SetStatusCallBack function, assigning its return value to a STATUSCALLBACK variable, and passing the pointer to your callback as the new value.
2.	Call the function that uses the callback (for example L_AverageFilterBitmap).
3.	Call the L_SetStatusCallBack function again, restoring the original value by passing the variable that you saved in Step 1.

Required DLLs and Libraries

LTKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista, Windows CE.

See Also

Functions:	STATUSCALLBACK, L_GetStatusCallBack
Topics:	Using Callback Functions

Example

/* This is the STATUSCALLBACK function, which stops the process if the user has pressed the interrupt key. */
L_BOOL KillProgress;

L_INT EXT_CALLBACK StatusCallBack (L_INT nPercent, L_VOID *pUserData)
{
   HWND hWnd=NULL;
   L_TCHAR achMsg[80]; /* message string */
   MSG msg;

   hWnd = (HWND)pUserData;

   /* Let the application detect other events - good for cancel */
   while (PeekMessage (&msg, NULL, 0, 0, PM_REMOVE))
   {
      TranslateMessage (&msg);
      DispatchMessage (&msg);
   }

   /* Check the global variable and return an error if necessary */
   if (KillProgress)
   {
      wsprintf (achMsg, TEXT("Interrupted by the user with %d percent finished"),nPercent);
      MessageBox (hWnd, achMsg, TEXT("Notice"), MB_OK);
      return (ERROR_USER_ABORT);
   }

   wsprintf(achMsg, TEXT("Percentage: %d\n"), nPercent);
   OutputDebugString(achMsg);

   return SUCCESS;
}

/* This function uses L_SetStatusCallBack to implement the STATUSCALLBACK
function when applying a median filter. */
L_INT SetStatusCallbackExample(BITMAPHANDLE *pBitmap)
{
   STATUSCALLBACK lpfnOldStatusCB;  /* Pointer to the previous STATUSCALLBACK function */
   L_INT nRet=SUCCESS;
   L_VOID * pOldData; /* Pointer to the user data for the previous status callback function */
   /* Set the STATUSCALLBACK function, saving the pointer to the previous one */
   L_SetStatusCallBack(StatusCallBack, NULL, &lpfnOldStatusCB, &pOldData );
   /* Apply an intentionally slow median filter with a neighborhood of 7x7 pixels */
   KillProgress = FALSE;
   nRet = L_MedianFilterBitmap(pBitmap, 7 );
   /* Restore the previous STATUSCALLBACK function */
   L_SetStatusCallBack (lpfnOldStatusCB, pOldData, NULL, NULL);
   return nRet;
}