DrvDisableSurface

DrvDisableSurface

VOID DrvDisableSurface(

IN DHPDEV dhpdev
);

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

Parameters

dhpdev

Handle to the PDEV that describes the physical device whose surface is to be released.

Comments

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 cannot access the hardware during DrvDisablePDEV 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 or not it has been disabled by DrvAssertMode so that it can perform proper cleanup operations in DrvDisablePDEV.

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

DrvDisableSurface is required for graphics drivers.