DdCreateSurfaceObject-Funktion (ddrawgdi.h)

  • Artikel

[Diese Funktion kann sich bei jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen Microsoft DirectDraw und Microsoft Direct3DAPIs. Diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und blenden viele andere Probleme aus, die bei der direkten Interaktion mit Anzeigetreibern auftreten.]

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

GdiEntry4 ist als Alias für diese Funktion definiert.

Syntax

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

Parameter

pSurfaceLocal

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

bPrimarySurface

Reserviert.

Rückgabewert

Bei erfolgreicher Ausführung 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 impliziten Teil des NtGdiDdCreateSurfaceObject-Aufrufs .

Anwendungen wird empfohlen, die DirectDraw- und Direct3D-APIs zum Erstellen und Verwalten von Grafikgeräteobjekten 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 des Grafikclients auf niedriger Ebene