IWICImagingFactory::CreateBitmapFromSource method (wincodec.h)

Creates a IWICBitmap from a IWICBitmapSource.

Syntax

HRESULT CreateBitmapFromSource(
  [in]  IWICBitmapSource           *pIBitmapSource,
  [in]  WICBitmapCreateCacheOption option,
  [out] IWICBitmap                 **ppIBitmap
);

Parameters

[in] pIBitmapSource

Type: IWICBitmapSource*

The IWICBitmapSource to create the bitmap from.

[in] option

Type: WICBitmapCreateCacheOption

The cache options of the new bitmap. This can be one of the values in the WICBitmapCreateCacheOption enumeration.

Value	Meaning
WICBitmapNoCache	Do not create a system memory copy. Share the bitmap with the source.
WICBitmapCacheOnDemand	Create a system memory copy when the bitmap is first used.
WICBitmapCacheOnLoad	Create a system memory copy when this method is called.

[out] ppIBitmap

Type: IWICBitmap**

A pointer that receives a pointer to the new bitmap.

Return value

Type: HRESULT

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

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