IWICBitmapFrameEncode：：SetPalette 方法 (wincodec.h)

  • 项目

为索引像素格式设置 IWICPalette 。

语法

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

参数

[in] pIPalette

类型： IWICPalette*

用于索引像素格式的 IWICPalette 。

编码器可能会更改调色板以反映编码器支持的像素格式。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果在像素格式设置为非索引像素格式的帧上调用此方法，则此方法不会失败。 如果目标像素格式是非索引格式，则将忽略调色板。

如果已调用 IWICBitmapEncoder：：SetPalette 来设置全局调色板，则此方法将替代当前帧的该调色板。

在首次调用 WritePixels/WriteSource 之前，必须指定调色板。 这样做将导致 WriteSource 在将源图像转换为编码器像素格式时使用指定的调色板。 如果未指定调色板，将在首次调用 WriteSource 时生成调 色板。

要求

要求 值
最低受支持的客户端 Windows XP SP2、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll