DrvDeriveSurface-Funktion (winddi.h)

Artikel
08/27/2023

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.