IWICFastMetadataEncoder

インプレースでのメタデータ編集に使用するメソッドを公開します。高速メタデータエンコーダーを使用すると、画像を完全に再エンコードすることなく、画像へのメタデータの追加や削除を行えます。

インプレースのメタデータ更新を実行するには、デコーダーを WICDecodeOptions の値 WICDecodeMetadataCacheOnDemand を使用して作成する必要があります。 WICDecodeMetadataCacheOnLoad オプションを使用すると、デコーダーはメタデータ更新の実行に必要なファイルストリームを解放してしまいます。

すべてのメタデータ形式が高速メタデータエンコードをサポートしているわけではありません。メタデータをサポートするネイティブのメタデータハンドラーは、IFD、Exif、XMP、GPS です。

高速メタデータエンコーダーが失敗した場合、メタデータを追加するには画像を完全に再エンコードする必要があります。

例

次の例は、画像フレームから高速メタデータエンコーダーを取得し、そのクエリライターを使用してメタデータ項目を書き込む方法を示しています。

IWICFastMetadataEncoder *pFME = NULL;
IWICMetadataQueryWriter *pFMEQW = NULL;

hr = pFactory->CreateFastMetadataEncoderFromFrameDecode(pFrameDecode, &pFME);

if (SUCCEEDED(hr))
{
     hr = pFME->GetMetadataQueryWriter(&pFMEQW);
}

if (SUCCEEDED(hr))
{
     // Add additional metadata
     PROPVARIANT value;

     PropVariantInit(&value);

     value.vt = VT_UI2;
     value.uiVal = 99;
     hr = pFMEQW->SetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);

     PropVariantClear(&value);
}

if (SUCCEEDED(hr))
{
     hr = pFME->Commit();
}

画像ストリームへのメタデータの変更を確定します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

コミットが失敗して WINCODEC_ERR_STREAMNOTAVAILABLE が返された場合は、画像デコーダーが WICDecodeMetadataCacheOnDemand オプションを使用して読み込まれていることを確認してください。デコーダーが WICDecodeMetadataCacheOnLoad オプションを使用して作成されている場合、高速メタデータエンコーダーはサポートされません。

コミットが何らかの理由で失敗した場合は、新しいメタデータが画像に確実に追加されるように、画像を再エンコードする必要があります。

高速メタデータエンコードのためのメタデータクエリライターを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。