Método IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)

Registra uma função de retorno de chamada de notificação de progresso.

Sintaxe

HRESULT RegisterProgressNotification(
  [in] PFNProgressNotification pfnProgressNotification,
  [in] LPVOID                  pvData,
  [in] DWORD                   dwProgressFlags
);

Parâmetros

[in] pfnProgressNotification

Tipo: PFNProgressNotification

Um ponteiro de função para a função de retorno de chamada de notificação de progresso definida pelo aplicativo. Consulte ProgressNotificationCallback para obter a assinatura de retorno de chamada.

[in] pvData

Tipo: LPVOID

Um ponteiro para dados de componente para o método de retorno de chamada.

[in] dwProgressFlags

Tipo: DWORD

Os sinalizadores WICProgressOperation e WICProgressNotification a serem usados para notificação de progresso.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os aplicativos só podem registrar um único retorno de chamada. As chamadas de registro subsequentes substituirão o retorno de chamada registrado anteriormente. Para cancelar o registro de um retorno de chamada, passe NULL ou registre uma nova função de retorno de chamada.

O progresso é relatado em uma ordem crescente entre 0,0 e 1,0. Se dwProgressFlags incluir WICProgressNotificationBegin, o retorno de chamada será chamado com o progresso 0.0. Se dwProgressFlags incluir WICProgressNotificationEnd, o retorno de chamada será chamado com o progresso 1.0.

WICProgressNotificationFrequent aumenta a frequência em que o retorno de chamada é chamado. Se espera-se que uma operação leve mais de 30 segundos, WICProgressNotificationFrequent deverá ser adicionado a dwProgressFlags.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib

Confira também

IWICBitmapCodecProgressNotification

ProgressNotificationCallback