Compartilhar via


Função de retorno de chamada ICMProgressProcCallback

A função ICMProgressProcCallback é uma função de retorno de chamada fornecida pelo aplicativo que relata o progresso e permite que o aplicativo cancele o processamento de cores.

Sintaxe

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

Parâmetros

ulMax

Especifica o valor máximo do contador de progresso (usado para estimar a conclusão do processamento de bitmap).

ulCurrent

Especifica o valor atual do contador de progresso (quando dividido pelo valor máximo, fornece uma estimativa aproximada do percentual de conclusão).

ulCallbackData

Especifica os dados que são passados pelo aplicativo para uma função ICM2, que os passa para a função de retorno de chamada. Esses dados podem ser usados, por exemplo, para identificar o bitmap e o processo sobre qual progresso está sendo relatado.

Valor retornado

Essa função retorna TRUE para continuar o processamento de bitmap. O valor retornado é FALSE para cancelar o processamento. Se o processamento for cancelado, a função de chamada retornará zero para indicar falha, embora seu buffer de saída possa ser parcialmente preenchido.

Comentários

O nome dessa função de retorno de chamada é fornecido pelo aplicativo. Várias funções do WCS, incluindo TranslateBitmapBits e CheckBitmapBits, chamam essa função periodicamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Icm.h

Confira também

Conceitos básicos de gerenciamento de cores

Funções

TranslateBitmapBits

CheckBitmapBits