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

コーデックに関連付けられているファイル名拡張子のコンマ区切りリストを取得します。

構文

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

パラメーター

[in] cchFileExtensions

型: UINT

ファイル名拡張子バッファーのサイズ。 最初の呼び出し時に を使用 0 して、必要なバッファー サイズを決定します。

[in, out] wzFileExtensions

種類: WCHAR*

コーデックに関連付けられているファイル名拡張子のコンマ区切りリストを受け取ります。 最初の呼び出し時に を使用 NULL して、必要なバッファー サイズを決定します。

[in, out] pcchActual

種類: UINT*

コーデックに関連付けられているすべてのファイル名拡張子を取得するために必要な実際のバッファー サイズ。

戻り値

種類: HRESULT

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

注釈

イメージ エンコーダーの既定の拡張機能は、返される拡張機能の一覧の最初の項目です。

このメソッドの使用パターンは、2 つの呼び出しプロセスです。 最初の呼び出しでは、cchFileExtensions を に設定し、wzFileExtensions を に0NULL設定して呼び出すことによって、フル カラー管理バージョン番号を取得するために必要なバッファー サイズを取得します。 この呼び出しは 、pcchActual を必要なバッファー サイズに設定します。 必要なバッファー サイズが決定されると、 cchFileExtensions がバッファー サイズに設定され、 wzFileExtensions が適切なサイズのバッファーに設定された 2 番目の GetFileExtensions 呼び出しによって、ピクセル形式が取得されます。

要件

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