Funzione di callback ICMProgressProcCallback
La funzione ICMProgressProcCallback è una funzione di callback fornita dall'applicazione che segnala lo stato di avanzamento e consente all'applicazione di annullare l'elaborazione dei colori.
Sintassi
BOOL WINAPI ICMProgressProcCallback(
ULONG ulMax,
ULONG ulCurrent,
LPARAM ulCallbackData
);
Parametri
-
ulMax
-
Specifica il valore massimo del contatore di stato (utilizzato per stimare il completamento dell'elaborazione bitmap).
-
ulCurrent
-
Specifica il valore corrente del contatore di stato (se diviso per il valore massimo, fornisce una stima approssimativa della percentuale di completamento).
-
ulCallbackData
-
Specifica i dati passati dall'applicazione a una funzione ICM2, che quindi lo passa alla funzione di callback. Tali dati possono essere usati, ad esempio, per identificare la bitmap e il processo su cui viene segnalato lo stato di avanzamento.
Valore restituito
Questa funzione restituisce TRUE per continuare l'elaborazione bitmap. Il valore restituito è FALSE per annullare l'elaborazione. Se l'elaborazione viene annullata, la funzione chiamante restituisce zero per indicare un errore, anche se il buffer di output potrebbe essere parzialmente riempito.
Commenti
Il nome di questa funzione di callback viene fornito dall'applicazione. Diverse funzioni WCS, tra cui TranslateBitmapBits e CheckBitmapBits, chiamano periodicamente questa funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|