PDD_SURFCB_DESTROYSURFACE Rückruffunktion (ddrawint.h)
Die DdDestroySurface-Rückruffunktion zerstört eine DirectDraw-Oberfläche.
Syntax
PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;
DWORD PddSurfcbDestroysurface(
PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DD_DESTROYSURFACEDATA Struktur, die die Informationen enthält, die zum Zerstören einer Oberfläche erforderlich sind.
Rückgabewert
DdDestroySurface gibt einen der folgenden Rückrufcodes zurück:
Hinweise
Wenn DirectDraw die Speicherbelegung zum Zeitpunkt der Surface-Erstellung ausgeführt hat und der Treiber nicht an der Zuordnung beteiligt war, ruft DirectDraw die DdDestroySurface-Funktion des Treibers nicht auf, um die Oberfläche zu zerstören.
Wenn der Treiber die Surface-Speicherverwaltung selbst ausführt, sollte DdDestroySurface den Surface-Speicher freigeben und andere Bereinigungen durchführen, z. B. das Freigeben privater Daten, die in den dwReserved1-Membern der DD_SURFACE_GLOBAL - und DD_SURFACE_LOCAL-Strukturen gespeichert sind.
Bei einer vom Treiber verwalteten Oberfläche kann DdDestroySurface aufgerufen werden, wenn die Oberfläche persistent ist (d. h. das DDSCAPS2_DONOTPERSIST-Flag im dwCaps2-Member der DDSCAPS2-Struktur für das Surface nicht festgelegt ist), DdDestroySurface kann aufgerufen werden, um die Oberfläche aus dem Videospeicher zu entfernen. In diesem Fall kann der Anzeigetreiber weiterhin alle privaten Daten in den dwReserved1-Membern beibehalten, bis DdDestroySurface aufgerufen wird, um die Oberfläche tatsächlich zu zerstören.
DdDestroySurface kann mit einem deaktivierten PDEV aufgerufen werden. PDEV wird durch Aufrufen der DrvAssertMode-Funktion des Anzeigetreibers deaktiviert oder aktiviert. Weitere Informationen finden Sie unter Verwalten von PDEVs .
Anforderungen
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (einschließlich Winddi.h) |