DrvDisableSurface

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

Syntax

VOID DrvDisableSurface( IN DHPDEV dhpdev );

Parameters

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

Remarks

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

If the driver has been disabled by a call to the DrvAssertMode function, the driver cannot access the hardware during a call to the DrvDisablePDEV function 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 this function before calling DrvDisablePDEV.

This function is required for graphics drivers.