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 |