IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode-Methode (wincodec.h)

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

Siehe auch

Konzept

IWICImagingFactory

Übersicht über die Metadaten-Abfragesprache

Übersicht über das Lesen und Schreiben von Bildmetadaten

Übersicht über WIC-Metadaten

Schreiben von Metadaten