Expand Minimize

ICMProgressProcCallback Callback Function

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

Syntax

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 Value

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Icm.h

See Also

Basic Color Management Concepts
Functions
TranslateBitmapBits
CheckBitmapBits

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.