ICMProgressProcCallback-Rückruffunktion

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

Syntax

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

Parameter

ulMax

Gibt den Höchstwert des Statusindikators an (wird verwendet, um den Abschluss der Bitmapverarbeitung zu schätzen).

ulCurrent

Gibt den aktuellen Wert des Fortschrittsindikators an (wenn er durch den Höchstwert dividiert ist, wird eine grobe Schätzung des Prozentsatzes des Abschlusses angegeben).

ulCallbackData

Gibt die Daten an, die von der Anwendung an eine ICM2-Funktion übergeben werden, die sie dann an die Rückruffunktion übergibt. Solche Daten können z. B. verwendet werden, um die Bitmap zu identifizieren und zu verarbeiten, welcher Fortschritt gemeldet wird.

Rückgabewert

Diese Funktion gibt TRUE zurück, um die Bitmapverarbeitung fortzufahren. Der Rückgabewert ist FALSE, um die Verarbeitung abzubricht. Wenn die Verarbeitung abgebrochen wird, gibt die aufrufende Funktion 0 (null) zurück, um auf einen Fehler hindeuten zu können, obwohl der Ausgabepuffer teilweise gefüllt sein kann.

Bemerkungen

Der Name dieser Rückruffunktion wird von der Anwendung angegeben. Eine Reihe von WCS-Funktionen, einschließlich TranslateBitmapBits und CheckBitmapBits,rufen diese Funktion regelmäßig 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

Weitere Informationen

Grundlegende Konzepte der Farbverwaltung

Funktionen

TranslateBitmapBits

CheckBitmapBits