EngCreateDeviceSurface (Windows CE 5.0)
This function creates and returns a handle to a surface that the driver manages.
HSURF EngCreateDeviceSurface( DHSURF dhsurf, SIZEL sizl, ULONG iFormatCompat);
Parameters
- dhsurf
[in] Handle to the surface to be managed. This handle passes to the driver when a SURFOBJ structure passes for input or output. - sizl
[in] SIZEL structure that contains the width and height of the surface to be created. The cx and cy members of this structure contain, respectively, the width and height of the surface, in pixels. A SIZEL structure is identical to a SIZE structure. - iFormatCompat
[in] Compatible engine format of the surface to be created. GDI uses this format if it requires a temporary buffer to simulate a drawing call.
Return Values
If the function call succeeds, this function returns a handle that identifies the surface. Otherwise, this function returns zero and logs an error code.
Remarks
The driver can optionally provide storage space for the surface. You should call the EngDeleteSurface function to delete the surface when the surface 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 | EngDeleteSurface
Send Feedback on this topic to the authors