Méthode IWICImagingFactory ::CreateFastMetadataEncoderFromFrameDecode (wincodec.h)

Article
03/06/2024

Crée une instance de l’encodeur de métadonnées rapide en fonction du cadre d’image donné.

Syntaxe

HRESULT CreateFastMetadataEncoderFromFrameDecode(
  [in]  IWICBitmapFrameDecode   *pIFrameDecoder,
  [out] IWICFastMetadataEncoder **ppIFastEncoder
);

Paramètres

[in] pIFrameDecoder

Type : IWICBitmapFrameDecode*

IWICBitmapFrameDecode à partir duquel créer le IWICFastMetadataEncoder.

[out] ppIFastEncoder

Type : IWICFastMetadataEncoder**

Lorsque cette méthode est retournée, contient un pointeur vers un nouvel encodeur de métadonnées rapide.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour obtenir la liste des formats de métadonnées pris en charge pour l’encodage rapide des métadonnées, consultez Vue d’ensemble des métadonnées WIC.

Exemples

Le code suivant montre comment utiliser la méthode CreateFastMetadataEncoderFromFrameDecode pour un encodage de métadonnées rapide.

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

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll