DrvDisableSurface

DrvDisableSurface function

The DrvDisableSurface function is used by GDI to notify a driver that the surface created by DrvEnableSurface for the current device is no longer needed.

Syntax


VOID DrvDisableSurface(
   DHPDEV dhpdev
);

Parameters

dhpdev

Handle to the physical device's PDEV. This is the handle to the device whose surface is to be released.

Return value

None

Remarks

The driver should free any memory and resources used by the surface associated with the PDEV as soon as the physical device is disabled.

If the driver has been disabled by a call to DrvAssertMode, the driver must not access the hardware during DrvDisableSurface because another active PDEV might be in use. Any necessary hardware changes should have been performed during the call to DrvAssertMode. A driver should keep track of whether it has been disabled by DrvAssertMode so that it can perform proper cleanup operations in DrvDisableSurface.

If the physical device has an enabled surface, GDI calls DrvDisableSurface before calling DrvDisablePDEV.

DrvDisableSurface is required for graphics drivers.

Requirements

Target platform

Header

Winddi.h (include Winddi.h)

See also

DrvAssertMode
DrvDisableDriver
DrvDisablePDEV
DrvEnableSurface

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft