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 |
请参阅
概念性