IWICBitmapCodecInfo::GetPixelFormats メソッド (wincodec.h)

コーデックでサポートされているピクセル形式を取得します。

構文

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

パラメーター

[in] cFormats

型: UINT

pguidPixelFormats 配列のサイズ。 最初の呼び出しで を使用 0 して、必要な配列サイズを決定します。

[in, out] pguidPixelFormats

型: GUID*

サポートされているピクセル形式を受け取ります。 最初の呼び出しで を使用 NULL して、必要な配列サイズを決定します。

[out] pcActual

種類: UINT*

サポートされているすべてのピクセル形式を取得するために必要な配列サイズ。

戻り値

種類: HRESULT

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

注釈

このメソッドの使用パターンは、2 つの呼び出しプロセスです。 最初の呼び出しでは、cFormats を に設定し、pguidPixelFormats を に0設定NULLして呼び出すことによって、サポートされているすべてのピクセル形式を取得するために必要な配列サイズを取得します。 この呼び出しは 、pcActual を必要な配列サイズに設定します。 必要な配列サイズが決定されると、pguidPixelFormats を適切なサイズの配列に設定した 2 番目の GetPixelFormats 呼び出しでピクセル形式が取得されます。

要件

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