IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode-Methode (wincodec.h)

Artikel
03/03/2024

Erstellt eine neue instance des schnellen Metadatenencoders basierend auf dem angegebenen Bildrahmen.

Syntax

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

Parameter

[in] pIFrameDecoder

Typ: IWICBitmapFrameDecode*

Der IWICBitmapFrameDecode , aus dem der IWICFastMetadataEncoder erstellt werden soll.

[out] ppIFastEncoder

Typ: IWICFastMetadataEncoder**

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen neuen schnellen Metadatenencoder.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine Liste der unterstützten Metadatenformate für die schnelle Metadatencodierung finden Sie unter Übersicht über WIC-Metadaten.

Beispiele

Der folgende Code veranschaulicht die Verwendung der CreateFastMetadataEncoderFromFrameDecode-Methode für die schnelle Metadatencodierung.

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

Anforderung	Wert
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
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll