IWICFastMetadataEncoder-Schnittstelle (wincodec.h)

Artikel
08/27/2023

Macht Methoden verfügbar, die für die direkte Metadatenbearbeitung verwendet werden. Mit einem schnellen Metadatenencoder können Sie Metadaten zu einem Bild hinzufügen und entfernen, ohne das Bild vollständig neu codieren zu müssen.

Vererbung

Die IWICFastMetadataEncoder-Schnittstelle erbt von der IUnknown-Schnittstelle . IWICFastMetadataEncoder verfügt auch über folgende Membertypen:

Methoden

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


IWICFastMetadataEncoder::Commit Schließt Metadatenänderungen am Bilddatenstrom ab.
IWICFastMetadataEncoder::GetMetadataQueryWriter Ruft einen Metadatenabfrage-Writer für die schnelle Metadatencodierung ab.

Hinweise

Ein Decoder muss mit dem WICDecodeOptions-WertWICDecodeMetadataCacheOnDemand erstellt werden, um direkte Metadatenupdates durchführen zu können. Wenn Sie die WICDecodeMetadataCacheOnLoad-Option verwenden, gibt der Decoder den Dateidatenstrom frei, der für die Metadatenupdates erforderlich ist.

Nicht alle Metadatenformate unterstützen die schnelle Metadatencodierung. Die nativen Metadatenhandler, die Metadaten unterstützen, sind IFD, Exif, XMP und GPS.

Wenn ein schneller Metadatenencoder fehlschlägt, muss das Bild vollständig neu codiert werden, um die Metadaten hinzuzufügen.

Beispiele

Im Folgenden wird veranschaulicht, wie Sie einen schnellen Metadatenencoder aus einem Bildrahmen abrufen und dessen Abfrage-Writer verwenden, um ein Metadatenelement zu schreiben.

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

Anforderungen


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

Freigeben über