Interface IWICFastMetadataEncoder (wincodec.h)

Expose les méthodes utilisées pour la modification des métadonnées sur place. Un encodeur de métadonnées rapide vous permet d’ajouter et de supprimer des métadonnées à une image sans avoir à réencoder entièrement l’image.

Héritage

L’interface IWICFastMetadataEncoder hérite de l’interface IUnknown. IWICFastMetadataEncoder possède également les types de membres suivants :

Méthodes

L’interface IWICFastMetadataEncoder a ces méthodes.

Remarques

Un décodeur doit être créé à l’aide de la valeur WICDecodeOptionsWICDecodeMetadataCacheOnDemand pour effectuer des mises à jour des métadonnées sur place. À l’aide de l’option WICDecodeMetadataCacheOnLoad , le décodeur libère le flux de fichiers nécessaire pour effectuer les mises à jour des métadonnées.

Tous les formats de métadonnées ne prennent pas en charge l’encodage rapide des métadonnées. Les gestionnaires de métadonnées natifs qui prennent en charge les métadonnées sont IFD, Exif, XMP et GPS.

Si un encodeur de métadonnées rapide échoue, l’image doit être entièrement réencodée pour ajouter les métadonnées.

Exemples

L’exemple suivant montre comment obtenir un encodeur de métadonnées rapide à partir d’un cadre d’image et utiliser son enregistreur de requêtes pour écrire un élément de métadonnées.

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

Configuration requise