Windows apps
Collapse the table of content
Expand the table of content
Information
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


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 | UWP apps]

Minimum supported server

Windows Server 2008 [desktop apps | UWP apps]

Header

Wincodec.h

IDL

Wincodec.idl

Library

Windowscodecs.lib

DLL

Windowscodecs.dll

See also

IWICImagingFactory
WIC GUIDs and CLSIDs

 

 

Show:
© 2017 Microsoft