IWICMetadataBlockWriter::SetWriterByIndex 方法 (wincodecsdk.h)

替换指定索引位置上的元数据编写器。

语法

HRESULT SetWriterByIndex(
  [in] UINT               nIndex,
  [in] IWICMetadataWriter *pIMetadataWriter
);

参数

[in] nIndex

类型: UINT

要放置元数据编写器的索引位置。 索引是从零开始的。

[in] pIMetadataWriter

类型: IWICMetadataWriter*

指向 IWICMetadataWriter 的指针。

返回值

类型: HRESULT

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

注解

通常,指定索引处的当前元数据编写器将替换为新的编写器。 但是,不能在 JPEG 流中替换 App0 元数据编写器。

此函数不能用于添加元数据编写器。 如果指定的索引处不存在元数据编写器,则函数将失败。

要求

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

请参阅

概念性

如何编写 WIC-Enabled CODEC

操作说明:使用元数据重新编码 JPEG 图像

IWICMetadataBlockWriter

其他资源

读取和写入图像元数据概述

WIC 元数据概述