DrvDisableSurface 函数 (winddi.h)

项目
08/27/2023

GDI 使用 DrvDisableSurface 函数通知驱动程序不再需要 DrvEnableSurface 为当前设备创建的表面。

语法

void DrvDisableSurface(
  DHPDEV dhpdev
);

参数

dhpdev

物理设备的 PDEV 的句柄。这是要释放其表面的设备图柄。

返回值

无

备注

禁用物理设备后，驱动程序应立即释放与 PDEV 关联的图面使用的任何内存和资源。

如果驱动程序已通过调用 DrvAssertMode 禁用，则驱动程序在 DrvDisableSurface 期间不得访问硬件，因为可能正在使用另一个活动 PDEV。调用 DrvAssertMode 期间应执行任何必要的硬件更改。驱动程序应跟踪 DrvAssertMode 是否禁用了它，以便它可以在 DrvDisableSurface 中执行适当的清理操作。

如果物理设备具有已启用的表面，GDI 在调用 DrvDisablePDEV 之前调用 DrvDisableSurface。

图形驱动程序需要 DrvDisableSurface。