IWICBitmapFrameEncode::SetThumbnail メソッド (wincodec.h)

コーデックでサポートされている場合は、フレームのサムネイルを設定します。

構文

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

パラメーター

[in] pIThumbnail

種類: IWICBitmapSource*

サムネイルとして使用するビットマップ ソース。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。

機能がエンコーダーでサポートされていない場合は、WINCODEC_ERR_UNSUPPORTEDOPERATIONを返します。

注釈

WritePixels または WriteSource を呼び出す前に、SetThumbnail を呼び出することをお勧めします。 WritePixels または WriteSource の呼び出し後に SetThumbnail が呼び出された場合、サムネイルはエンコードされたファイルに追加されません。

  • BMP、PNGサムネイルの設定はサポートされていません。 この関数は 、WINCODEC_ERR_UNSUPPORTEDOPERATIONを返します。
  • Jpegサムネイルの設定がサポートされています。 ソース イメージは 8bpp または 24bpp JPEG として再エンコードされ、JPEG の APP1 メタデータ ブロックに書き込まれます。
  • Tiff サムネイルの設定がサポートされています。 ソース イメージは TIFF として再エンコードされ、フレームの SubIFD ブロックに書き込まれます。
  • JPEG-XRサムネイルの設定がサポートされています。 ソース イメージは、追加の 8bpp または 24bpp フレームとして再エンコードされます。

要件

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

関連項目

概念

エンコードの概要

WIC-Enabled コーデックを記述する方法

IWICBitmapFrameEncode