PDD_FREEDRIVERMEMORY Rückruffunktion (ddrawint.h)
Die DdFreeDriverMemory-Rückruffunktion gibt offscreen- oder nichtlokalen Anzeigespeicher frei, um eine neue Zuordnungsanforderung zu erfüllen.
Syntax
PDD_FREEDRIVERMEMORY PddFreedrivermemory;
DWORD PddFreedrivermemory(
PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DD_FREEDRIVERMEMORYDATA-Struktur , die die Details der kostenlosen Anforderung enthält.
Rückgabewert
DdFreeDriverMemory gibt einen der folgenden Rückrufcodes zurück:
Hinweise
Der Treiber sollte DdFreeDriverMemory implementieren, wenn directDraw die gesamte Speicherverwaltung des Offscreen-Bildschirms verwaltet, einschließlich Zuordnungen für DrvCreateDeviceBitmap. DirectDraw-Anforderungen für Zuordnungen im Offscreenspeicher sollten immer Vorrang vor GDI-Geräte-Bitmapzuordnungen haben.
DirectDraw ruft DdFreeDriverMemory auf, wenn es nicht über genügend Offscreen- oder nicht lokal verfügbaren Anzeigespeicher verfügt, um eine von einer Anwendung angeforderte Oberfläche zuzuordnen. Der Treiber sollte eine GDI-Geräte-Bitmap aus dem Offscreenspeicher in den Systemspeicher verschieben und dann sofort zurückkehren. Bitmapverschiebungen können durch Aufrufen von EngModifySurface erreicht werden.
DirectDraw ruft DdFreeDriverMemory kontinuierlich auf, bis genügend Offscreenspeicher vorhanden ist, um die angeforderte Oberfläche zuzuordnen, oder bis der Treiber DDERR_OUTOFMEMORY zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (include Winddi.h) |