ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES*,ID2D1Bitmap**) method (d2d1.h)

Creates an ID2D1Bitmap by copying the specified Microsoft Windows Imaging Component (WIC) bitmap.

Syntax

HRESULT CreateBitmapFromWicBitmap(
        IWICBitmapSource             *wicBitmapSource,
        const D2D1_BITMAP_PROPERTIES *bitmapProperties,
  [out] ID2D1Bitmap                  **bitmap
);

Parameters

wicBitmapSource

Type: [in] IWICBitmapSource*

The WIC bitmap to copy.

bitmapProperties

Type: [in, optional] const D2D1_BITMAP_PROPERTIES*

The pixel format and DPI of the bitmap to create. The pixel format must match the pixel format of wicBitmapSource, or the method will fail. To prevent a mismatch, you can pass NULL or pass the value obtained from calling the D2D1::PixelFormat helper function without specifying any parameter values. If both dpiX and dpiY are 0.0f, the default DPI, 96, is used. DPI information embedded in wicBitmapSource is ignored.

[out] bitmap

Type: ID2D1Bitmap**

When this method returns, contains the address of a pointer to the new bitmap. This parameter is passed uninitialized.

Return value

Type: HRESULT

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

Remarks

Before Direct2D can load a WIC bitmap, that bitmap must be converted to a supported pixel format and alpha mode. For a list of supported pixel formats and alpha modes, see Supported Pixel Formats and Alpha Modes.

Examples

For examples, see How to Load a Bitmap from a File and How to Load a Bitmap from a Resource.

Requirements

See also

How to Load a Bitmap from a File

ID2D1Bitmap

ID2D1RenderTarget

Supported Pixel Formats and Alpha Modes