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