DrvDisableSurface-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvDisableSurface-Funktion wird von GDI verwendet, um einen Treiber zu benachrichtigen, dass die von DrvEnableSurface für das aktuelle Gerät erstellte Oberfläche nicht mehr benötigt wird.

Syntax

void DrvDisableSurface(
  DHPDEV dhpdev
);

Parameter

dhpdev

Handle zum PDEV des physischen Geräts. Dies ist der Ziehpunkt für das Gerät, dessen Oberfläche freigegeben werden soll.

Rückgabewert

Keine

Bemerkungen

Der Treiber sollte alle Arbeitsspeicher und Ressourcen freigeben, die von der Oberfläche verwendet werden, die dem PDEV zugeordnet ist, sobald das physische Gerät deaktiviert ist.

Wenn der Treiber durch einen Aufruf von DrvAssertMode deaktiviert wurde, darf der Treiber während von DrvDisableSurface nicht auf die Hardware zugreifen, da möglicherweise ein anderer aktiver PDEV verwendet wird. Alle erforderlichen Hardwareänderungen sollten während des Aufrufs von DrvAssertMode durchgeführt worden sein. Ein Treiber sollte nachverfolgen, ob er von DrvAssertMode deaktiviert wurde, damit er ordnungsgemäße Bereinigungsvorgänge in DrvDisableSurface ausführen kann.

Wenn das physische Gerät über eine aktivierte Oberfläche verfügt, ruft GDI DrvDisableSurface auf, bevor DrvDisablePDEV aufgerufen wird.

DrvDisableSurface ist für Grafiktreiber erforderlich.