EngCreateDeviceSurface (Windows Embedded CE 6.0)

1/6/2010

This function creates and returns a handle to a surface that the driver manages.

Syntax

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 Value

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

See Also

Reference

GDI Functions for Display Drivers
EngDeleteSurface