IWICFastMetadataEncoder-Schnittstelle (wincodec.h)

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.

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