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。