DrvEnableSurface

This function sets up a surface to draw on and associates it with a specified PDEV.

HSURF DrvEnableSurface(
  DHPDEV dhpdev 
);

Parameters

  • dhpdev
    [in] Handle to a PDEV structure. This value is the return value of the DrvEnablePDEV function. The PDEV describes the physical device to create a surface for.

Return Values

Handle that identifies the newly created surface indicates success. Zero indicates failure.

Remarks

This function is required for graphics drivers.

Depending on the device and circumstances, if the driver manages its own surface, the driver can call the EngCreateDeviceSurface function to get a handle to the surface.

Any existing GDI bitmap handle is a valid surface handle.

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_perm3_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.

See Also

Display Drivers | DrvDisableSurface | DrvEnablePDEV

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.