Metodo IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode (wincodec.h)

Articolo
03/13/2024

Crea una nuova istanza del codificatore di metadati veloce in base al frame di immagine specificato.

Sintassi

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

Parametri

[in] pIFrameDecoder

Tipo: IWICBitmapFrameDecode*

IWICBitmapFrameDecode da cui creare IWICFastMetadataEncoder.

[out] ppIFastEncoder

Tipo: IWICFastMetadataEncoder**

Quando questo metodo restituisce, contiene un puntatore a un nuovo codificatore di metadati veloce.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per un elenco di formati di metadati di supporto per la codifica rapida dei metadati, vedere Panoramica dei metadati WIC.

Esempio

Il codice seguente illustra come usare il metodo CreateFastMetadataEncoderFromFrameDecode per la codifica rapida dei 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

Requisito	Valore
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
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll