PFND3DDDI_SETRENDERSTATE Rückruffunktion (d3dumddi.h)

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.

Bemerkungen

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

Anforderungen

Siehe auch

D3DDDIARG_RENDERSTATE

D3DDDI_DEVICEFUNCS