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 エラー コードを返します。

注釈

アプリケーションでは、1 つのコールバックのみを登録できます。 それ以降の登録呼び出しでは、以前に登録されたコールバックが置き換えられます。 コールバックの登録を解除するには、 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
Library	Windowscodecs.lib

こちらもご覧ください

IWICBitmapCodecProgressNotification

ProgressNotificationCallback