DdCreateDirectDrawObject-Funktion (ddrawgdi.h)

  • Artikel

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

Wrapper für die NtGdiDdCreateDirectDrawObject-Funktion und erstellt eine kernelseitige Darstellung des Microsoft DirectDraw-Objekts. Ein Handle für diese Darstellung wird in pDirectDrawGlobal-hDD> gespeichert.

GdiEntry1 ist als Alias für diese Funktion definiert.

Syntax

BOOL DdCreateDirectDrawObject(
  LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal,
  HDC                     hdc
);

Parameter

pDirectDrawGlobal

Zeiger auf das DirectDraw-Objekt im Benutzermodus. Ausführliche Informationen finden Sie in der DDK-Dokumentation.

hdc

Behandeln Sie den DC für das Gerät, für das diese Darstellung erstellt wird. Bei 0 ist das Gerät das "Anzeigegerät". Beachten Sie, dass diese Funktion nur ein DirectDraw-Objekt "anzeigen" behält und ein kopiertes Handle an dasselbe Objekt zurückgibt, wenn sie anschließend mit hdc = 0 aufgerufen wird.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Anwendungen wird empfohlen, die DirectDraw- und Direct3D-APIs zum Erstellen und Verwalten von Grafikgeräteobjekten zu verwenden. Diese Konstrukte abstrahieren den Prozess der Geräteerstellung vereinfacht und betriebssystemunabhängig.

Anforderungen

Anforderung Wert
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

Low-Level-Clientunterstützung für Grafiken