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 |
関連項目
概念