Metode IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode (wincodec.h)

Artikel
03/03/2024

Membuat instans baru encoder metadata cepat berdasarkan bingkai gambar yang diberikan.

Sintaks

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

Parameter

[in] pIFrameDecoder

Jenis: IWICBitmapFrameDecode*

IWICBitmapFrameDecode untuk membuat IWICFastMetadataEncoder dari.

[out] ppIFastEncoder

Jenis: IWICFastMetadataEncoder**

Ketika metode ini kembali, berisi penunjuk ke encoder metadata cepat baru.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Untuk daftar format metadata dukungan untuk pengodean metadata cepat, lihat Gambaran Umum Metadata WIC.

Contoh

Kode berikut menunjukkan cara menggunakan metode CreateFastMetadataEncoderFromFrameDecode untuk pengodean metadata cepat.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll