NtGdiD3DDrawPrimitives2-Funktion

  • Artikel

[Diese Funktion kann sich mit jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen die Microsoft 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.]

Rendert Primitive und gibt den aktualisierten Renderzustand zurück.

Syntax

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Parameter

hCmdBuf [in]

Handle mit der DD_SURFACE_LOCAL-Struktur , die die DirectDraw-Oberfläche mit den Befehlsdaten identifiziert.

hVBuf [in]

Handle mit der DD_SURFACE_LOCAL-Struktur , die die DirectDraw-Oberfläche mit den Vertexdaten identifiziert.

pded [in, out]

Zeiger auf eine D3DNTHAL_DRAWPRIMITIVES2DATA-Struktur , die die Informationen enthält, die der Treiber zum Rendern eines oder mehrerer Grundtypen benötigt.

pfpVidMemCmd [in, out]

Neuer Zeiger auf Videospeicher, wenn der Treiber den Befehlspuffer ausgetauscht hat.

pdwSizeCmd [in, out]

Gibt die Mindestanzahl von Bytes an, um die der Treiber den Swapbefehlpuffer erhöhen muss.

pfpVidMemVtx [in, out]

Neuer Zeiger auf den Videospeicher, wenn der Treiber den Vertexpuffer ausgetauscht hat.

pdwSizeVtx [in, out]

Gibt die Mindestanzahl von Bytes an, die der Treiber für den Swap-Vertexpuffer zuordnen muss.

Rückgabewert

NtGdiD3DDrawPrimitives2 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, fährt DirectDraw oder Direct3D mit der Funktion fort. 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 wäre der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden.

 

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

Low-Level-Clientunterstützung für Grafiken