IWICImageEncoder::WriteThumbnail メソッド (wincodec.h)

指定したイメージを、指定された WIC ビットマップ エンコーダーのサムネイルとしてエンコードします。

構文

HRESULT WriteThumbnail(
  [in] ID2D1Image               *pImage,
  [in] IWICBitmapEncoder        *pEncoder,
  [in] const WICImageParameters *pImageParameters
);

パラメーター

[in] pImage

種類: ID2D1Image*

エンコードされる Direct2D イメージ。

[in] pEncoder

種類: IWICBitmapEncoder*

サムネイルが設定されているエンコーダー。

[in] pImageParameters

種類: const WICImageParameters*

エンコードを制御するための追加のパラメーター。

戻り値

種類: HRESULT

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

解説

IWICImagingFactory2::CreateImageEncoder と同じデバイスで渡すイメージを作成する必要があります。 pImageParameters が指す変数に追加のパラメーターを指定しない場合、エンコーダーでは便利な既定値のセットが使用されます。 これらの既定値の詳細については、「 WICImageParameters」を参照してください。

WriteThumbnail を呼び出す前に、サムネイルを設定するエンコーダーの IWICBitmapEncoder インターフェイスを設定する必要があります。

WriteThumbnail が失敗した場合は、エンコーダーからE_OUTOFMEMORY、D2DERR_WRONG_RESOURCE_DOMAIN、またはその他のエラー コードが返されることがあります。

要件

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

関連項目

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters