EngCreateDeviceBitmap (Windows Embedded CE 6.0)

1/6/2010

This function requests GDI to create a handle to a bitmap image.

Syntax

HBITMAP EngCreateDeviceBitmap(
  DHSURF dhsurf,
  SIZEL sizl,
  ULONG iFormatCompat
);

Parameters

• dhsurf
  [in] Handle to the bitmap image to be created.

• sizl
  [in] SIZEL structure that contains the width and height of the bitmap image to be created. The cx and cy members of this structure contain, respectively, the width and height of the bitmap image, in pixels. A SIZEL structure is identical to a SIZE structure.

• iFormatCompat
  [in] Compatible engine format of the bitmap image to be created. GDI uses this format if it requires a temporary buffer to simulate a drawing call. For this parameter, you can specify a value of BMF_1BPP, BMF_4BPP, BMF_8BPP, BMF_16BPP, BMF_24BPP, or BMF_32BPP.

Return Value

If the function call succeeds, this function returns a handle that identifies the bitmap image. Otherwise, this function returns zero and logs an error code.

Remarks

You should call the EngDeleteSurface function to delete the bitmap image when the bitmap image is no longer needed.

Requirements

See Also

Reference

GDI Functions for Display Drivers