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

Consulte también

IWICBitmapCodecProgressNotification

ProgressNotificationCallback