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

本机像素格式