DrvDisableSurface function (winddi.h)

Article
02/22/2024

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)