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초 이상 걸릴 것으로 예상되는 경우 WICProgressNotificationFrequent 를 dwProgressFlags에 추가해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib

추가 정보

IWICBitmapCodecProgressNotification

ProgressNotificationCallback