PFND3DDDI_SETRENDERSTATE Rückruffunktion (d3dumddi.h)

  • Artikel

Die SetRenderState-Funktion aktualisiert einen Renderzustand.

Syntax

PFND3DDDI_SETRENDERSTATE Pfnd3dddiSetrenderstate;

HRESULT Pfnd3dddiSetrenderstate(
  HANDLE hDevice,
  const D3DDDIARG_RENDERSTATE *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDIARG_RENDERSTATE Struktur, die beschreibt, wie der Renderzustand aktualisiert wird.

Rückgabewert

SetRenderState gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn der Renderzustand nicht erfolgreich aktualisiert wurde.

Hinweise

Die Microsoft Direct3D-Runtime ordnet BeginScene - und EndScene-Aufrufe von Anwendungen der SetRenderState-Funktion des Benutzermodusanzeigetreibers zu. Wenn die Runtime einen BeginScene-Aufruf empfängt, legt sie das State-Element der D3DDDIARG_RENDERSTATE-Struktur fest, auf das pData auf D3DRENDERSTATE_SCENECAPTURE verweist, und das Value-Element von D3DDDIARG_RENDERSTATE auf TRUE und ruft dann SetRenderState auf. Wenn die Runtime einen EndScene-Aufruf empfängt, legt sie den State-Member auf D3DRENDERSTATE_SCENECAPTURE und das Value-Element auf FALSE fest und ruft dann SetRenderState auf. Zwischen diesen Aufrufen von SetRenderState erfasst der Treiber geometrische Daten in einem Frame.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_RENDERSTATE

D3DDDI_DEVICEFUNCS