ID2D1RenderTarget::CreateBitmap method

Creates a Direct2D bitmap from a pointer to in-memory source data.

Syntax

HRESULT CreateBitmap(
  D2D1_SIZE_U                    size,
  const void                     *srcData,
  UINT32                         pitch,
  const D2D1_BITMAP_PROPERTIES & bitmapProperties,
  ID2D1Bitmap                    **bitmap
);

Parameters

size

Type: D2D1_SIZE_U

The dimensions of the bitmap to create in pixels.

srcData

Type: void*

A pointer to the memory location of the image data, or NULL to create an uninitialized bitmap.

pitch

Type: UINT32

The byte count of each scanline, which is equal to (the image width in pixels × the number of bytes per pixel) + memory padding. If srcData is NULL, this value is ignored. (Note that pitch is also sometimes called stride.)

bitmapProperties

Type: const D2D1_BITMAP_PROPERTIES

The pixel format and dots per inch (DPI) of the bitmap to create.

bitmap

Type: ID2D1Bitmap**

When this method returns, contains a pointer to 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.

Requirements

   
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1.h
Library D2d1.lib
DLL D2d1.dll

See Also

ID2D1RenderTarget