IWICBitmapEncoder：：CreateNewFrame 方法 (wincodec.h)

  • 项目

创建新的 IWICBitmapFrameEncode 实例。

语法

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

参数

[out] ppIFrameEncode

类型： IWICBitmapFrameEncode**

一个指针，该指针接收指向 IWICBitmapFrameEncode 的新实例的指针。

[in, out] ppIEncoderOptions

类型： IPropertyBag2**

可选。 接收用于后续帧初始化的命名属性。 请参阅“备注”。

返回值

类型： HRESULT

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

注解

参数 ppIEncoderOptions 可用于接收 IPropertyBag2，该 IPropertyBag2 随后可用于指定编码器选项。 这是通过将指针传递到 ppIEncoderOptions 中的 NULL IPropertyBag2 指针来完成的。 返回的 IPropertyBag2 使用可用于给定格式的所有编码器选项（其默认值）进行初始化。 若要指定非默认编码行为，请在 IPropertyBag2 上设置所需的编码器选项，并将其传递给 IWICBitmapFrameEncode：：Initialize。

注意 不要传入指向已初始化的 IPropertyBag2 的指针。 将覆盖指针，并且不会释放原始 IPropertyBag2。
 
否则，如果不打算指定编码器选项，则可以在 ppIEncoderOptions 中传递 NULL。

有关如何设置编码器选项的示例，请参阅 编码概述 。

对于支持编码多个帧的格式 (例如 TIFF、JPEG-XR) ，一次只能处理一个帧。 这意味着，在再次调用 CreateNewFrame 之前，必须调用 IWICBitmapFrameEncode：：Commit。

要求

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

另请参阅

编码概述

IPropertyBag2

IWICBitmapEncoder