IWICMetadataQueryWriter interface (wincodec.h)

Article
02/22/2024

Exposes methods for setting or removing metadata blocks and items to an encoder or its image frames using a metadata query expression.

Inheritance

The IWICMetadataQueryWriter interface inherits from IWICMetadataQueryReader. IWICMetadataQueryWriter also has these types of members:

Methods

The IWICMetadataQueryWriter interface has these methods.


IWICMetadataQueryWriter::RemoveMetadataByName Removes a metadata item from a specific location using a metadata query expression.
IWICMetadataQueryWriter::SetMetadataByName Sets a metadata item to a specific location.

Remarks

A metadata query writer uses metadata query expressions to set or remove metadata. For more information on the metadata query language, see the Metadata Query Language Overview.

Examples

The following code demonstrates how to create an XMP query writer and add a new metadata item to it.

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

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	wincodec.h