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
| Header | winddi.h |
| 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, Ddi_tvia5_lib.lib |
| Windows Embedded CE | Windows CE 1.0 and later |