Antarmuka IWICMetadataQueryWriter (wincodec.h)

Artikel
08/27/2023

Mengekspos metode untuk mengatur atau menghapus blok metadata dan item ke encoder atau bingkai gambarnya menggunakan ekspresi kueri metadata.

Warisan

Antarmuka IWICMetadataQueryWriter mewarisi dari IWICMetadataQueryReader. IWICMetadataQueryWriter juga memiliki jenis anggota ini:

Metode

Antarmuka IWICMetadataQueryWriter memiliki metode ini.


IWICMetadataQueryWriter::RemoveMetadataByName Menghapus item metadata dari lokasi tertentu menggunakan ekspresi kueri metadata.
IWICMetadataQueryWriter::SetMetadataByName Mengatur item metadata ke lokasi tertentu.

Keterangan

Penulis kueri metadata menggunakan ekspresi kueri metadata untuk mengatur atau menghapus metadata. Untuk informasi selengkapnya tentang bahasa kueri metadata, lihat Gambaran Umum Bahasa Kueri Metadata.

Contoh

Kode berikut menunjukkan cara membuat penulis kueri XMP dan menambahkan item metadata baru ke dalamnya.

// Create XMP block
IWICMetadataQueryWriter *pXMPWriter = NULL;

if (SUCCEEDED(hr))
{
    hr = pFactory->CreateQueryWriter(GUID_MetadataFormatXMP, NULL, &pXMPWriter);
}

// Write metadata to the XMP writer
if (SUCCEEDED(hr))
{
    PROPVARIANT value;
    PropVariantInit(&value);

    value.vt = VT_LPWSTR;
    value.pwszVal = L"Metadata Test Image.";
	
    hr = pXMPWriter->SetMetadataByName(L"/dc:title", &value);

    PropVariantClear(&value);
}

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