Método IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)
Registra una función de devolución de llamada de notificación de progreso.
Sintaxis
HRESULT RegisterProgressNotification(
[in] PFNProgressNotification pfnProgressNotification,
[in] LPVOID pvData,
[in] DWORD dwProgressFlags
);
Parámetros
[in] pfnProgressNotification
Tipo: PFNProgressNotification
Puntero de función a la función de devolución de llamada de notificación de progreso definida por la aplicación. Consulte ProgressNotificationCallback para obtener la firma de devolución de llamada.
[in] pvData
Tipo: LPVOID
Puntero a los datos de componentes para el método de devolución de llamada.
[in] dwProgressFlags
Tipo: DWORD
Las marcas WICProgressOperation y WICProgressNotification que se usarán para la notificación de progreso.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Las aplicaciones solo pueden registrar una sola devolución de llamada. Las llamadas de registro posteriores reemplazarán la devolución de llamada registrada anteriormente. Para anular el registro de una devolución de llamada, pase NULL o registre una nueva función de devolución de llamada.
El progreso se notifica en un orden creciente entre 0,0 y 1,0. Si dwProgressFlags incluye WICProgressNotificationBegin, se garantiza que la devolución de llamada se llame con el progreso 0.0. Si dwProgressFlags incluye WICProgressNotificationEnd, se garantiza que la devolución de llamada se llame con el progreso 1.0.
WICProgressNotificationFrequent aumenta la frecuencia en la que se llama a la devolución de llamada. Si se espera que una operación tarde más de 30 segundos, se debe agregar WICProgressNotificationFrequent a dwProgressFlags.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | wincodec.h |
Library | Windowscodecs.lib |