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
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll

另請參閱

概念

如何撰寫 WIC-Enabled CODEC

作法:使用中繼資料重新編碼 JPEG 影像

IWICMetadataBlockWriter

其他資源

讀取和寫入影像中繼資料的概觀

WIC 中繼資料概觀