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

另请参阅

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters