NtGdiDdCreateD3DBuffer-Funktion

Artikel
06/03/2023

[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 blenden viele andere Probleme aus, die bei der direkten Interaktion mit Anzeigetreibern auftreten.]

Wird verwendet, um einen Befehl auf Treiberebene oder einen Vertexpuffer der angegebenen Beschreibung zu erstellen.

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ächenziehpunkten. Der Aufrufer kann diese Handles auf die vorherigen Handlewerte festlegen, wenn die Oberflächen nach einem Moduswechsel neu erstellt werden. Dieser Vorgang 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 DD_SURFACE_GLOBAL 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 normalerweise nur ein Eintrag vorhanden.
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_DRIVER_HANDLED	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_DRIVER_NOTHANDLED	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.

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

Weitere Informationen

Unterstützung des Grafikclients auf niedriger Ebene

Freigeben über