IWICMetadataBlockWriter::SetWriterByIndex メソッド (wincodecsdk.h)

指定したインデックス位置にあるメタデータ ライターを置き換えます。

構文

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

パラメーター

[in] nIndex

型: UINT

メタデータ ライターを配置するインデックス位置。 このインデックスは 0 から始まります。

[in] pIMetadataWriter

種類: IWICMetadataWriter*

IWICMetadataWriter へのポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

通常、指定したインデックスにある現在のメタデータ ライターは、新しいライターに置き換えられます。 ただし、APP0 メタデータ ライターは JPEG ストリーム内で置き換えることはできません。

この関数を使用してメタデータ ライターを追加することはできません。 指定したインデックスにメタデータ ライターが存在しない場合、関数は失敗します。

要件

   
サポートされている最小のクライアント WINDOWS XP と SP2、Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincodecsdk.h
Library Windowscodecs.lib
[DLL] Windowscodecs.dll

関連項目

概念

WIC-Enabled コーデックを記述する方法

方法: メタデータを使用して JPEG イメージを再エンコードする

IWICMetadataBlockWriter

その他のリソース

画像メタデータの読み取りと書き込みの概要

WIC メタデータの概要