DrvDisableSurface function (winddi.h)
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
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | winddi.h (include Winddi.h) |