IWICBitmapFrameDecode::GetColorContexts メソッド (wincodec.h)

イメージ フレームに関連付けられている IWICColorContext を取得します。

構文

HRESULT GetColorContexts(
  [in]      UINT             cCount,
  [in, out] IWICColorContext **ppIColorContexts,
  [out]     UINT             *pcActualCount
);

パラメーター

[in] cCount

型: UINT

取得するカラー コンテキストの数。

この値は、 ppIColorContexts で使用できるサイズのサイズまたはそれより小さい値である必要があります。

[in, out] ppIColorContexts

種類: IWICColorContext**

IWICColorContext オブジェクトへのポインターを受け取るポインター。

[out] pcActualCount

種類: UINT*

イメージ フレームに含まれる色コンテキストの数を受け取るポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ppIColorContexts に NULL が渡され、cCount に 0 が渡された場合、このメソッドは pcActualCount 内のイメージ内のカラー コンテキストの合計数を返します。

ppIColorContexts 配列には有効なデータが入力されている必要があります。配列内の各 IWICColorContext* は、IWICImagingFactory::CreateColorContext を使用して作成されている必要があります。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincodec.h
Library	Windowscodecs.lib