IWICBitmapDecoder::CopyPalette メソッド (wincodec.h)

デコーダーの IWICPalette をコピーします。

構文

HRESULT CopyPalette(
  [in] IWICPalette *pIPalette
);

パラメーター

[in] pIPalette

種類: IWICPalette*

デコーダーのグローバル パレットをコピーするIWICPalette 。 CopyPalette を呼び出す前に、CreatePalette を使用してコピー先パレットを作成します。

戻り値

型: HRESULT

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

注釈

CopyPalette は、グローバル パレット (イメージ内のすべてのフレームに適用されるパレット) を返します (存在する場合)。それ以外の場合は、WINCODEC_ERR_PALETTEUNAVAILABLEを返します。 イメージにグローバル パレットがない場合でも、 IWICBitmapFrameDecode::CopyPalette を使用して取得できるフレーム レベルのパレットが残っている可能性があります。

要件