IWICImagingFactory::CreateDecoder method

Creates a new instance of IWICBitmapDecoder.

Syntax


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.

ValueMeaning
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.

ValueMeaning
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

See also

IWICImagingFactory
WIC GUIDs and CLSIDs

 

 

Community Additions

ADD
Show:
© 2014 Microsoft