IWICBitmapFrameEncode::SetPixelFormat メソッド (wincodec.h)

  • [アーティクル]

エンコーダーが指定したピクセル形式を使用することを要求します。

構文

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

パラメーター

[in, out] pPixelFormat

種類: WICPixelFormatGUID*

入力時に、要求されたピクセル形式の GUID。 出力時に、エンコーダーでサポートされている最も近いピクセル形式 GUID。これは、要求された形式とは異なる場合があります。 ピクセル形式 GUID の一覧については、「 ネイティブ ピクセル形式」を参照してください。

戻り値

型: HRESULT

可能な戻り値は次のとおりです。

リターン コード 説明
S_OK
 正常終了しました。
WINCODEC_ERR_WRONGSTATE
 IWICBitmapFrameEncode::Initialize メソッドが呼び出されませんでした。

注釈

エンコーダーは、要求されたピクセル形式をサポートしていない可能性があります。 そうでない場合、SetPixelFormat は pPixelFormat が指すメモリ ブロック内の最も近い一致を返します。 返されたピクセル形式が要求された形式と一致しない場合は、 IWICFormatConverter オブジェクトを使用してピクセル データを変換する必要があります。

要件

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

こちらもご覧ください

IWICBitmapFrameEncode

ネイティブ ピクセル形式