Bagikan melalui

Antarmuka IWICFastMetadataEncoder (wincodec.h)

  • Artikel

Mengekspos metode yang digunakan untuk pengeditan metadata di tempat. Encoder metadata cepat memungkinkan Anda menambahkan dan menghapus metadata ke gambar tanpa harus sepenuhnya mengodekan ulang gambar.

Warisan

Antarmuka IWICFastMetadataEncoder mewarisi dari antarmuka IUnknown . IWICFastMetadataEncoder juga memiliki jenis anggota ini:

Metode

Antarmuka IWICFastMetadataEncoder memiliki metode ini.

 
IWICFastMetadataEncoder::Commit

Menyelesaikan perubahan metadata pada aliran gambar.
IWICFastMetadataEncoder::GetMetadataQueryWriter

Mengambil penulis kueri metadata untuk pengodean metadata cepat.

Keterangan

Dekoder harus dibuat menggunakan nilai WICDecodeOptionsWICDecodeMetadataCacheOnDemand untuk melakukan pembaruan metadata di tempat. Menggunakan opsi WICDecodeMetadataCacheOnLoad menyebabkan dekoder merilis aliran file yang diperlukan untuk melakukan pembaruan metadata.

Tidak semua format metadata mendukung pengodean metadata cepat. Penangan metadata asli yang mendukung metadata adalah IFD, Exif, XMP, dan GPS.

Jika encoder metadata cepat gagal, gambar harus dikodekan ulang sepenuhnya untuk menambahkan metadata.

Contoh

Berikut ini menunjukkan cara mendapatkan encoder metadata cepat dari bingkai gambar dan menggunakan penulis kuerinya untuk menulis item metadata.

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

   
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