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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |