Antarmuka IWICFastMetadataEncoder (wincodec.h)
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 |