EngCreateDeviceBitmap (Windows CE 5.0)

Send Feedback

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

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 Values

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

OS Versions: Windows CE 1.0 and later.
Header: Winddi.h.
Link Library: Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.

See Also

GDI Functions for Display Drivers

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.