Freigeben über


IWICMetadataQueryWriter-Schnittstelle (wincodec.h)

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

Siehe auch

Konzept

Vorgehensweise: Erneutes Codieren eines JPEG-Bilds mit Metadaten

IWICMetadataQueryReader

Übersicht über die Metadaten-Abfragesprache

Übersicht über das Lesen und Schreiben von Bildmetadaten

Übersicht über WIC-Metadaten