ICMProgressProcCallback, funkcja wywołania zwrotnego

Funkcja ICMProgressProcCallback to funkcja wywołania zwrotnego dostarczana przez aplikację, która zgłasza postęp i zezwala aplikacji na anulowanie przetwarzania kolorów.

Składnia

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

Parametry

ulMax

Określa maksymalną wartość licznika postępu (służy do szacowania ukończenia przetwarzania mapy bitowej).

ulCurrent

Określa bieżącą wartość licznika postępu (gdy jest podzielona przez wartość maksymalną, zapewnia przybliżone oszacowanie procentu ukończenia).

ulCallbackData

Określa dane przekazywane przez aplikację do funkcji ICM2, która następnie przekazuje je do funkcji wywołania zwrotnego. Takie dane mogą służyć na przykład do identyfikowania mapy bitowej i procesu raportowania postępu.

Wartość zwracana

Ta funkcja zwraca true, aby kontynuować przetwarzanie map bitowych. Wartość zwracana jest false do anulowania przetwarzania. Jeśli przetwarzanie zostanie anulowane, funkcja wywołująca zwraca zero, aby wskazać błąd, chociaż jego bufor wyjściowy może być częściowo wypełniony.

Uwagi

Nazwa tej funkcji wywołania zwrotnego jest dostarczana przez aplikację. Wiele funkcji WCS, w tym TranslateBitmapBits i CheckBitmapBits, okresowo wywołuje tę funkcję.

Wymagania

Zobacz też

podstawowe pojęcia dotyczące zarządzania kolorami

Functions

TranslateBitmapBits

CheckBitmapBits