Share via

ICMProgressProcCallback

  • Article

The ICMProgressProcCallback function is an application-supplied callback function that reports progress and permits the application to cancel color processing.

BOOL WINAPI ICMProgressProcCallback(
  ULONG ulMax,  ULONG ulCurrent,  LPARAM ulCallbackData);

Parameters

  • ulMax
    Specifies the maximum value of the progress counter (used to estimate completion of the bitmap processing).
  • ulCurrent
    Specifies the current value of the progress counter (when divided by the maximum value, provides a rough estimate of percentage of completion).
  • ulCallbackData
    Specifies the data which is passed by the application to an ICM2 function, which then passes it on to the callback function. Such data can be used, for example, to identify the bitmap and process about which progress is being reported.

Return Values

This function returns TRUE to continue bitmap processing. The return value is FALSE to cancel processing. If processing is canceled, the calling function returns zero to indicate failure, although its output buffer may be partially filled.

Remarks

The name of this callback function is supplied by the application. A number of WCS functions, including TranslateBitmapBits and CheckBitmapBits, call this function periodically.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Icm.h.

See Also

Basic Color Management Concepts, Functions, TranslateBitmapBits, CheckBitmapBits