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

コンバーターがサポートするピクセル形式を示す GUID の一覧を取得します。

構文

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

パラメーター

[in] cFormats

型: UINT

pPixelFormatGUIDs 配列のサイズ。

[in, out] pPixelFormatGUIDs

種類: WICPixelFormatGUID*

コンバーターがサポートするピクセル形式を受け取る GUID 配列へのポインター。

[out] pcActual

型: UINT*

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

戻り値

型: HRESULT

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

注釈

フォーマットコンバータは、必ずしも変換に関して対称性を保証するとは限りません。つまり、コンバーターは、実際に特定の形式に変換しなくても、特定の形式から変換できます。 対称性をテストするには、 CanConvert を使用します。

コンバーターで処理できるピクセル形式の数を確認するには、 cFormats を に 0 、 pPixelFormatGUIDs を に NULL設定します。 コンバーターは pcActual に、そのコンバーターでサポートされている形式の数を入力します。

要件