IWICImagingFactory::CreateFastMetadataEncoderFromDecoder method (wincodec.h)

Article
02/22/2024

Creates a new instance of the fast metadata encoder based on the given IWICBitmapDecoder.

Syntax

HRESULT CreateFastMetadataEncoderFromDecoder(
  [in]  IWICBitmapDecoder       *pIDecoder,
  [out] IWICFastMetadataEncoder **ppIFastEncoder
);

Parameters

[in] pIDecoder

Type: IWICBitmapDecoder*

The decoder to create the fast metadata encoder from.

[out] ppIFastEncoder

Type: IWICFastMetadataEncoder**

When this method returns, contains a pointer to the new IWICFastMetadataEncoder.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The Windows provided codecs do not support fast metadata encoding at the decoder level, and only support fast metadata encoding at the frame level. To create a fast metadata encoder from a frame, see CreateFastMetadataEncoderFromFrameDecode.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	wincodec.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll