Метод 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 |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по