DrvDisableSurface-Funktion (winddi.h)
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.
Anforderungen
| Zielplattform | Desktop |
| Kopfzeile | winddi.h (einschließlich Winddi.h) |