DrvDisablePDEV

VOID DrvDisablePDEV(

IN DHPDEV  dhpdev
);

DrvDisablePDEV is used by GDI to notify a driver that the specified PDEV is no longer needed.

Parameters

dhpdev

Pointer to the PDEV that describes the physical device to be disabled. This value is the handle returned by DrvEnablePDEV.

Comments

If the driver has been disabled by a call to DrvAssertMode, the driver cannot access the hardware during DrvDisableSurface because another active surface 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 DrvDisableSurface.

If the physical device has an enabled surface, GDI calls DrvDisablePDEV after calling DrvDisableSurface. The driver should free any memory and resources used by the PDEV.

DrvDisablePDEV is required for graphics drivers.

See Also

DrvAssertMode, DrvEnablePDEV