Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

IWICImagingFactory::CreateEncoder method (wincodec.h)

Creates a new instance of the IWICBitmapEncoder class.

Syntax

HRESULT CreateEncoder(
 [in] REFGUID guidContainerFormat,
 [in, optional] const GUID *pguidVendor,
 [out, retval] IWICBitmapEncoder **ppIEncoder
);

Parameters

[in] guidContainerFormat

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.

[in, optional] pguidVendor

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.

[out, retval] ppIEncoder

Type: IWICBitmapEncoder**

A pointer that receives a pointer to a new IWICBitmapEncoder.

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

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

See also

IWICImagingFactory

WIC GUIDs and CLSIDs

Feedback

Was this page helpful?

Additional resources

  • Last updated on