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 |