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

コーデックに関連付けられているデバイス モデルのコンマ区切りの一覧を取得します。

構文

HRESULT GetDeviceModels(
  [in]      UINT  cchDeviceModels,
  [in, out] WCHAR *wzDeviceModels,
  [in, out] UINT  *pcchActual
);

パラメーター

[in] cchDeviceModels

型: UINT

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

[in, out] wzDeviceModels

種類: WCHAR*

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

[in, out] pcchActual

型: UINT*

すべてのデバイス モデル名を取得するために必要な実際のバッファー サイズ。

戻り値

型: HRESULT

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

解説

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

要件

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