IWICMetadataQueryWriter-Schnittstelle (wincodec.h)

Artikel
03/06/2024

Macht Methoden zum Festlegen oder Entfernen von Metadatenblöcken und Elementen für einen Encoder oder dessen Bildframes mithilfe eines Metadatenabfrageausdrucks verfügbar.

Vererbung

Die IWICMetadataQueryWriter-Schnittstelle erbt von IWICMetadataQueryReader. IWICMetadataQueryWriter verfügt auch über folgende Membertypen:

Methoden

Die IWICMetadataQueryWriter-Schnittstelle verfügt über diese Methoden.


IWICMetadataQueryWriter::RemoveMetadataByName Entfernt ein Metadatenelement von einem bestimmten Speicherort mithilfe eines Metadatenabfrageausdrucks.
IWICMetadataQueryWriter::SetMetadataByName Legt ein Metadatenelement an einem bestimmten Speicherort fest.

Hinweise

Ein Metadatenabfrage-Writer verwendet Metadatenabfrageausdrücke, um Metadaten festzulegen oder zu entfernen. Weitere Informationen zur Sprache der Metadatenabfrage finden Sie unter Übersicht über die Metadatenabfragesprache.

Beispiele

Der folgende Code veranschaulicht, wie Sie einen XMP-Abfragewriter erstellen und diesem ein neues Metadatenelement hinzufügen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h