ICMProgressProcCallback, fonction de rappel
La fonction ICMProgressProcCallback est une fonction de rappel fournie par l’application qui signale la progression et permet à l’application d’annuler le traitement des couleurs.
Syntaxe
BOOL WINAPI ICMProgressProcCallback(
ULONG ulMax,
ULONG ulCurrent,
LPARAM ulCallbackData
);
Paramètres
-
ulMax
-
Spécifie la valeur maximale du compteur de progression (utilisé pour estimer l’achèvement du traitement bitmap).
-
ulCurrent
-
Spécifie la valeur actuelle du compteur de progression (divisé par la valeur maximale, fournit une estimation approximative du pourcentage d’achèvement).
-
ulCallbackData
-
Spécifie les données qui sont transmises par l’application à une fonction ICM2, qui les transmet ensuite à la fonction de rappel. Ces données peuvent être utilisées, par exemple, pour identifier la bitmap et le processus sur lesquels la progression est signalée.
Valeur retournée
Cette fonction retourne TRUE pour poursuivre le traitement bitmap. La valeur de retour est FALSE pour annuler le traitement. Si le traitement est annulé, la fonction appelante retourne zéro pour indiquer l’échec, même si sa mémoire tampon de sortie peut être partiellement remplie.
Notes
Le nom de cette fonction de rappel est fourni par l’application. Plusieurs fonctions WCS, notamment TranslateBitmapBitBits et CheckBitmapBitBits, appellent cette fonction régulièrement.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|