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 |
|