The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IWICImagingFactory::CreateDecoder method

Creates a new instance of IWICBitmapDecoder.

Syntax

C++


HRESULT CreateDecoder(
  [in]                REFGUID           guidContainerFormat,
  [in, unique]  const GUID              *pguidVendor,
  [out, retval]       IWICBitmapDecoder **ppIDecoder
);

Parameters

guidContainerFormat [in]

Type: REFGUID

The GUID for the desired container format.

Value	Meaning
GUID_ContainerFormatBmp	The BMP container format GUID.
GUID_ContainerFormatPng	The PNG container format GUID.
GUID_ContainerFormatIco	The ICO container format GUID.
GUID_ContainerFormatJpeg	The JPEG container format GUID.
GUID_ContainerFormatTiff	The TIFF container format GUID.
GUID_ContainerFormatGif	The GIF container format GUID.
GUID_ContainerFormatWmp	The HD Photo container format GUID.

pguidVendor [in]

Type: const GUID*

The GUID for the preferred encoder vendor.

Value	Meaning
NULL	No preferred codec vendor.
GUID_VendorMicrosoft	Prefer to use Microsoft encoder.
GUID_VendorMicrosoftBuiltIn	Prefer to use the native Microsoft encoder.

ppIDecoder [out, retval]

Type: IWICBitmapDecoder**

A pointer that receives a pointer to a new IWICBitmapDecoder. You must initialize this IWICBitmapDecoder on a stream using the Initialize method later.

Return value

Type: HRESULT

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

Remarks

Other values may be available for both guidContainerFormat and pguidVendor depending on the installed WIC-enabled encoders. The values listed are those that are natively supported by the operating system.

Requirements

Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2008 [desktop apps \| Windows Store apps]
Header	Wincodec.h
IDL	Wincodec.idl
Library	Windowscodecs.lib
DLL	Windowscodecs.dll