Función de devolución de llamada ICMProgressProcCallback

La función ICMProgressProcCallback es una función de devolución de llamada proporcionada por la aplicación que notifica el progreso y permite que la aplicación cancele el procesamiento de color.

Sintaxis

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

Parámetros

ulMax

Especifica el valor máximo del contador de progreso (que se usa para calcular la finalización del procesamiento del mapa de bits).

ulCurrent

Especifica el valor actual del contador de progreso (cuando se divide por el valor máximo, proporciona una estimación aproximada del porcentaje de finalización).

ulCallbackData

Especifica los datos que la aplicación pasa a una función ICM2, que luego la pasa a la función de devolución de llamada. Estos datos se pueden usar, por ejemplo, para identificar el mapa de bits y el proceso sobre qué progreso se notifica.

Valor devuelto

Esta función devuelve TRUE para continuar el procesamiento del mapa de bits. El valor devuelto es FALSE para cancelar el procesamiento. Si se cancela el procesamiento, la función de llamada devuelve cero para indicar un error, aunque su búfer de salida puede rellenarse parcialmente.

Comentarios

La aplicación proporciona el nombre de esta función de devolución de llamada. Varias funciones WCS, incluidas TranslateBitmapBits y CheckBitmapBits, llaman a esta función periódicamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Icm.h

Consulte también

Conceptos básicos de administración de colores

Funciones

TranslateBitmapBits

CheckBitmapBits