Interfaccia IWICFastMetadataEncoder (wincodec.h)

Articolo
08/27/2023

Espone i metodi usati per la modifica dei metadati sul posto. Un codificatore di metadati rapido consente di aggiungere e rimuovere metadati a un'immagine senza dover codificare completamente l'immagine.

Ereditarietà

L'interfaccia IWICFastMetadataEncoder eredita dall'interfaccia IUnknown . IWICFastMetadataEncoder ha anche questi tipi di membri:

Metodi

L'interfaccia IWICFastMetadataEncoder include questi metodi.


IWICFastMetadataEncoder::Commit Finalizza le modifiche dei metadati al flusso di immagini.
IWICFastMetadataEncoder::GetMetadataQueryWriter Recupera un writer di query di metadati per la codifica rapida dei metadati.

Commenti

Per eseguire gli aggiornamenti dei metadati sul posto, è necessario creare un decodificatore usando il valore WICDecodeOptionsWICDecodeMetadataCacheOnDemand . L'uso dell'opzione WICDecodeMetadataCacheOnLoad fa sì che il decodificatore rilasci il flusso di file necessario per eseguire gli aggiornamenti dei metadati.

Non tutti i formati di metadati supportano la codifica rapida dei metadati. I gestori di metadati nativi che supportano i metadati sono IFD, Exif, XMP e GPS.

Se un codificatore di metadati rapido non riesce, l'immagine dovrà essere completamente codificata per aggiungere i metadati.

Esempio

Di seguito viene illustrato come ottenere un codificatore di metadati rapido da un frame di immagine e usare il writer di query per scrivere un elemento di metadati.

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

Requisiti


Client minimo supportato	Windows XP con SP2, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h

Condividi tramite