DrvDeriveSurface-Funktion (winddi.h)
Die DrvDeriveSurface-Funktion leitet eine GDI-Oberfläche von der angegebenen DirectDraw-Oberfläche ab.
Syntax
HBITMAP DrvDeriveSurface(
DD_DIRECTDRAW_GLOBAL *pDirectDraw,
DD_SURFACE_LOCAL *pSurface
);
Parameter
pDirectDraw
Zeiger auf eine DD_DIRECTDRAW_GLOBAL-Struktur , die das DirectDraw-Objekt beschreibt.
pSurface
Zeiger auf eine DD_SURFACE_LOCAL Struktur, die die DirectDraw-Oberfläche beschreibt, um die eine GDI-Oberfläche umschließen soll.
Rückgabewert
DrvDeriveSurface gibt bei Erfolg einen Handle an die abgeleitete GDI-Oberfläche zurück. Er gibt NULL zurück, wenn der Aufruf fehlschlägt oder wenn der Treiber die GDI-Zeichnung nicht auf die angegebene DirectDraw-Oberfläche beschleunigen kann.
Hinweise
DrvDeriveSurface ermöglicht es dem Treiber, eine GDI-Oberfläche zu erstellen, die um einen DirectDraw-Videospeicher oder ein AGP-Oberflächenobjekt umschlossen ist, um beschleunigtes GDI-Zeichnen auf der Oberfläche zu ermöglichen. Wenn der Treiber diesen Aufruf nicht anhängt, werden alle GDI-Zeichnungen an DirectDraw-Oberflächen in Software mit der DIB-Engine ausgeführt.
GDI ruft DrvDeriveSurface nur mit RGB-Oberflächen auf.
Der Treiber sollte DrvCreateDeviceBitmap aufrufen, um eine GDI-Oberfläche mit der gleichen Größe und dem gleichen Format wie die DirectDraw-Oberfläche zu erstellen. Der Platz für die eigentlichen Pixel muss nicht zugewiesen werden, da er bereits vorhanden ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winddi.h (einschließlich Winddi.h) |