Метод IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)

  • Статья

Регистрирует функцию обратного вызова уведомления о ходе выполнения.

Синтаксис

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

Параметры

[in] pfnProgressNotification

Тип: PFNProgressNotification

Указатель функции на функцию обратного вызова уведомления о ходе выполнения, определяемую приложением. Сигнатуру обратного вызова см. в разделе ProgressNotificationCallback .

[in] pvData

Тип: LPVOID

Указатель на данные компонента для метода обратного вызова.

[in] dwProgressFlags

Тип: DWORD

Флаги WICProgressOperation и WICProgressNotification , используемые для уведомления о ходе выполнения.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Приложения могут зарегистрировать только один обратный вызов. Последующие вызовы регистрации заменят ранее зарегистрированный обратный вызов. Чтобы отменить регистрацию обратного вызова, передайте значение NULL или зарегистрируйте новую функцию обратного вызова.

О прогрессе сообщается в порядке увеличения от 0,0 до 1,0. Если dwProgressFlags включает WICProgressNotificationBegin, обратный вызов гарантированно будет вызываться с выполнением 0.0. Если dwProgressFlags включает WICProgressNotificationEnd, обратный вызов гарантированно будет вызываться с выполнением 1.0.

WICProgressNotificationFrequent увеличивает частоту вызова обратного вызова. Если ожидается, что операция занимает более 30 секунд, в dwProgressFlags следует добавить WICProgressNotificationFrequent.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib

См. также раздел

IWICBitmapCodecProgressNotification

ProgressNotificationCallback