DdCreateSurfaceObject-Funktion (ddrawgdi.h)

[Diese Funktion unterliegt änderungen an jeder Betriebssystemversion. Verwenden Sie stattdessen die Microsoft DirectDraw- und Microsoft Direct3DAPIs; diese APIs isolieren Anwendungen von solchen Betriebssystemänderungen und ausblenden viele andere Schwierigkeiten, die mit Anzeigetreibern direkt interagieren.]

Wrapper für die Funktion NtGdiDdCreateSurfaceObject und erstellt ein Kernelmodus-Surface-Objekt.

GdiEntry4 wird als Alias für diese Funktion definiert.

Syntax

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

Parameter

pSurfaceLocal

Zeiger auf das Benutzermodus-Surface-Objekt. Weitere Informationen finden Sie in der DDK-Dokumentation. Ein Handle zum Kernelmodusobjekt wird in pSurfaceLocal-hDDSurface> platziert.

bPrimarySurface

Reserviert.

Rückgabewert

Wenn die Funktion erfolgreich verläuft, gibt diese Funktion TRUE zurück; andernfalls wird FALSE zurückgegeben.

Hinweise

Diese Funktion wird verwendet, um Objekte zu erstellen, die Systemspeicheroberflächen darstellen. Videospeicheroberflächen erhalten eine Kernelmodusdarstellung als impliziter Teil des NtGdiDdCreateSurfaceObject-Aufrufs .

Anwendungen werden empfohlen, die DirectDraw- und Direct3D-APIs zum Erstellen und Verwalten von Grafikgerätobjekten zu verwenden. Diese Konstrukte abstrahieren den Geräteerstellungsprozess auf vereinfachte und betriebssystemunabhängige Weise.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ddrawgdi.h

Weitere Informationen

Unterstützung von Grafiken auf niedriger Ebene