IWICBitmapDecoder interface

Exposes methods that represent a decoder.

The interface provides access to the decoder's properties such as global thumbnails (if supported), frames, and palette.

Members

The IWICBitmapDecoder interface inherits from the IUnknown interface. IWICBitmapDecoder also has these types of members:

Methods

The IWICBitmapDecoder interface has these methods.

MethodDescription
CopyPalette

Copies the decoder's IWICPalette .

GetColorContexts

Retrieves the IWICColorContext objects of the image.

GetContainerFormat

Retrieves the image's container format.

GetDecoderInfo

Retrieves an IWICBitmapDecoderInfo for the image.

GetFrame

Retrieves the specified frame of the image.

GetFrameCount

Retrieves the total number of frames in the image.

GetMetadataQueryReader

Retrieves the metadata query reader from the decoder.

GetPreview

Retrieves a preview image, if supported.

GetThumbnail

Retrieves a bitmap thumbnail of the image, if one exists

Initialize

Initializes the decoder with the provided stream.

QueryCapability

Retrieves the capabilities of the decoder based on the specified stream.

 

Remarks

There are a number of concrete implemenations of this interface representing each of the standard decoders provided by the platform including bitmap (BMP), Portable Network Graphics (PNG), icon (ICO), Joint Photographic Experts Group (JPEG), Graphics Interchange Format (GIF), Tagged Image File Format (TIFF), and Microsoft Windows Digital Photo (WDP). The following table includes the class identifier (CLSID) for each native decoder.

CLSID NameCLSID
CLSID_WICBmpDecoder0x6b462062, 0x7cbf, 0x400d, 0x9f, 0xdb, 0x81, 0x3d, 0xd1, 0xf, 0x27, 0x78
CLSID_WICPngDecoder0x389ea17b, 0x5078, 0x4cde, 0xb6, 0xef, 0x25, 0xc1, 0x51, 0x75, 0xc7, 0x51
CLSID_WICIcoDecoder0xc61bfcdf, 0x2e0f, 0x4aad, 0xa8, 0xd7, 0xe0, 0x6b, 0xaf, 0xeb, 0xcd, 0xfe
CLSID_WICJpegDecoder0x9456a480, 0xe88b, 0x43ea, 0x9e, 0x73, 0xb, 0x2d, 0x9b, 0x71, 0xb1, 0xca
CLSID_WICGifDecoder0x381dda3c, 0x9ce9, 0x4834, 0xa2, 0x3e, 0x1f, 0x98, 0xf8, 0xfc, 0x52, 0xbe
CLSID_WICTiffDecoder0xb54e85d9, 0xfe23, 0x499f, 0x8b, 0x88, 0x6a, 0xce, 0xa7, 0x13, 0x75, 0x2b
CLSID_WICWmpDecoder0xa26cec36, 0x234c, 0x4950, 0xae, 0x16, 0xe3, 0x4a, 0xac, 0xe7, 0x1d, 0x0d

 

This interface may be sub-classed to provide support for third party codecs as part of the extensibility model. See the AITCodec Sample CODEC.

Codecs written as TIFF container formats that are not register will decode as a TIFF image. Client applications should check for a zero frame count to determine if the codec is valid.

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

Conceptual
Windows Imaging Component Overview
WIC GUIDs and CLSIDs
Other Resources
How to Write a WIC-Enabled CODEC
AITCodec Sample CODEC

 

 

Community Additions

ADD
Show:
© 2014 Microsoft