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.
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) |