IWICImagingFactory：：CreateFastMetadataEncoderFromFrameDecode 方法 (wincodec.h)

發行項
03/03/2024

根據指定的影像框架，建立快速元數據編碼器的新實例。

語法

HRESULT CreateFastMetadataEncoderFromFrameDecode(
  [in]  IWICBitmapFrameDecode   *pIFrameDecoder,
  [out] IWICFastMetadataEncoder **ppIFastEncoder
);

參數

[in] pIFrameDecoder

類型： IWICBitmapFrameDecode*

從建立 IWICFastMetadataEncoder 的 IWICBitmapFrameDecode。

[out] ppIFastEncoder

類型： IWICFastMetadataEncoder**

當這個方法傳回時，會包含新快速元數據編碼器的指標。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

如需快速元數據編碼的支援元數據格式清單，請參閱 WIC 元數據概觀。

範例

下列程式代碼示範如何使用 CreateFastMetadataEncoderFromFrameDecode 方法進行快速元數據編碼。

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();
}

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib
Dll	Windowscodecs.dll