Freigeben über


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.

 
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