IWICImagingFactory::CreateDecoderFromFilename method

Creates a new instance of the IWICBitmapDecoder class based on the given file.

Syntax

HRESULT CreateDecoderFromFilename(
  LPCWSTR           wzFilename,
  const GUID        *pguidVendor,
  DWORD             dwDesiredAccess,
  WICDecodeOptions  metadataOptions,
  IWICBitmapDecoder **ppIDecoder
);

Parameters

wzFilename

Type: LPCWSTR

A pointer to a null-terminated string that specifies the name of an object to create or open.

pguidVendor

Type: const GUID*

The GUID for the preferred decoder vendor. Use NULL if no preferred vendor.

dwDesiredAccess

Type: DWORD

The access to the object, which can be read, write, or both.

Value Meaning
GENERIC_READ
Read access.
GENERIC_WRITE
Write access.
 

For more information, see Generic Access Rights.

metadataOptions

Type: WICDecodeOptions

The WICDecodeOptions to use when creating the decoder.

ppIDecoder

Type: IWICBitmapDecoder**

A pointer that receives a pointer to the new IWICBitmapDecoder.

Return Value

Type: HRESULT

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

Requirements

   
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