IWICBitmapFrameEncode：：SetPixelFormat 方法 (wincodec.h)

  • 项目

请求编码器使用指定的像素格式。

语法

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

参数

[in, out] pPixelFormat

类型： WICPixelFormatGUID*

输入时，请求的像素格式 GUID。 输出时，编码器支持的最接近的像素格式 GUID;这可能不同于请求的格式。 有关像素格式 GUID 的列表，请参阅 本机像素格式。

返回值

类型： HRESULT

可能的返回值包括以下内容。

返回代码 说明
S_OK
 成功。
WINCODEC_ERR_WRONGSTATE
 未调用 IWICBitmapFrameEncode：：Initialize 方法。

注解

编码器可能不支持请求的像素格式。 否则， SetPixelFormat 返回 pPixelFormat 指向的内存块中最近的匹配项。 如果返回的像素格式与请求的格式不匹配，则必须使用 IWICFormatConverter 对象来转换像素数据。

要求

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

另请参阅

IWICBitmapFrameEncode

本机像素格式