NtGdiDdCreateD3DBuffer-Funktion

[Diese Funktion kann bei jeder Betriebssystemrevision geändert werden. Verwenden Sie stattdessen Microsoft DirectDraw und Microsoft Direct3DAPIs. Diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten bei der direkten Interaktion mit Anzeigetreibern.]

Wird zum Erstellen eines Befehls oder Scheitelpunktpuffers auf Treiberebene der angegebenen Beschreibung verwendet.

Syntax

DWORD APIENTRY NtGdiDdCreateD3DBuffer(
  _In_    HANDLE               hDirectDraw,
  _Inout_ HANDLE               *hSurface,
  _Inout_ DDSURFACEDESC        *puSurfaceDescription,
  _Inout_ DD_SURFACE_GLOBAL    *puSurfaceGlobalData,
  _Inout_ DD_SURFACE_LOCAL     *puSurfaceLocalData,
  _Inout_ DD_SURFACE_MORE      *puSurfaceMoreData,
  _Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
  _Inout_ HANDLE               *puhSurface
);

Parameter

hDirectDraw [ In]

Handle für die DD _ DIRECTDRAW _ GLOBAL-Struktur, die den Treiber darstellt.

hSurface [ in, out]

Zeiger auf ein Array von Oberflächenhandles. Der Aufrufer kann diese Handles auf die vorherigen Handlewerte festlegen, wenn die Oberflächen nach einem Moduswechsel neu erstellt werden. Dieser Prozess wird in der DirectDraw-Dokumentation als "Wiederherstellen" bezeichnet.

puSurfaceDescription [ in, out]

Zeiger auf eine DDSURFACEDESC-Struktur, die die Oberfläche oder den Puffer beschreibt, die der Treiber erstellen soll.

puSurfaceGlobalData [ in, out]

Zeiger auf eine globale DD _ _ SURFACE-Struktur, die Oberflächendaten enthält, die global für mehrere Oberflächen freigegeben werden.

puSurfaceLocalData [ in, out]

Zeiger auf eine Liste von DD _ SURFACE _ LOCAL-Strukturen, die die vom Treiber erstellten Oberflächenobjekte beschreiben. In diesem Array ist in der Regel nur ein Eintrag zu finden.

puSurfaceMoreData [ in, out]

Zeiger auf eine DD _ SURFACE _ MORE-Struktur, die zusätzliche lokale Oberflächendaten enthält.

puCreateSurfaceData [ in, out]

Zeiger auf eine DD _ CREATESURFACEDATA-Struktur, die die zum Erstellen des Puffers erforderlichen Informationen enthält.

puhSurface [ in, out]

Wird von der DirectDraw-API verwendet und sollte nicht vom Treiber ausgefüllt werden.

Rückgabewert

NtGdiDdCreateD3DBuffer gibt einen der folgenden Rückrufcodes zurück.

Rückgabecode Beschreibung
_DDHAL-TREIBER _ BEHANDELT
Der Treiber hat den Vorgang ausgeführt und einen gültigen Rückgabecode für diesen Vorgang zurückgegeben. Wenn dieser Code DD _ OK ist, wird DirectDraw oder Direct3D mit der Funktion fortgesetzt. Andernfalls gibt DirectDraw oder Direct3D den vom Treiber bereitgestellten Fehlercode zurück und bricht die Funktion ab.
_DDHAL-TREIBER _ NICHT BEHANDELT
Der Treiber hat keinen Kommentar zum angeforderten Vorgang. Wenn der Treiber einen bestimmten Rückruf implementiert haben muss, meldet DirectDraw oder Direct3D eine Fehlerbedingung. Andernfalls verarbeitet DirectDraw oder Direct3D den Vorgang so, als ob der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden wäre.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Ntgdi.h

Siehe auch

Clientunterstützung auf niedriger Grafikebene