|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
This function sets up a surface to be drawn on and associates it with a specified PDEV.
HSURF DrvEnableSurface( IN DHPDEV dhpdev );
A handle that identifies the newly created surface indicates success. Zero indicates failure.
Depending on the device and circumstances, the driver can do any of the following to enable the surface:
Any existing GDI bitmap handle is a valid surface handle.
Before defining and returning a surface, a graphics driver must associate the surface with the physical device using the EngAssociateSurfacefunction. This GDI function allows the driver to specify which graphics output routines are supported for standard format bitmaps. A call to this function can only be made when no surface exists for the specified physical device.
This function is required for graphics drivers.
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||1.0 and later|
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004