ICMProgressProcCallback-Rückruffunktion

Die ICMProgressProcCallback-Funktion ist eine von der Anwendung bereitgestellte Rückruffunktion, die den Status meldet und der Anwendung das Abbrechen der Farbverarbeitung ermöglicht.

Syntax

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

Parameter

ulMax

Gibt den maximalen Wert des Fortschrittsindikators an (der zum Schätzen der Vervollständigung der Bitmapverarbeitung verwendet wird).

ulCurrent

Gibt den aktuellen Wert des Fortschrittsindikators an (wenn er durch den Maximalwert dividiert wird, stellt eine grobe Schätzung des Prozentsatzes der Fertigstellung bereit).

ulCallbackData

Gibt die Daten an, die von der Anwendung an eine ICM2-Funktion übergeben werden, die sie dann an die Rückruffunktion weitergibt. Solche Daten können beispielsweise verwendet werden, um die Bitmap und den Prozess zu identifizieren, über den der Fortschritt gemeldet wird.

Rückgabewert

Diese Funktion gibt TRUE zurück, um die Bitmapverarbeitung fortzusetzen. Der Rückgabewert ist FALSE , um die Verarbeitung abzubrechen. Wenn die Verarbeitung abgebrochen wird, gibt die aufrufende Funktion null zurück, um einen Fehler anzuzeigen, obwohl ihr Ausgabepuffer teilweise gefüllt ist.

Bemerkungen

Der Name dieser Rückruffunktion wird von der Anwendung angegeben. Eine Reihe von WCS-Funktionen, einschließlich TranslateBitmapBits und CheckBitmapBits, rufen diese Funktion in regelmäßigen Abständen auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Icm.h

Siehe auch

Grundlegende Farbmanagementkonzepte

Funktionen

TranslateBitmapBits

CheckBitmapBits