PFND3DDDI_SETRENDERSTATE funzione di callback (d3dumddi.h)
La funzione SetRenderState aggiorna uno stato di rendering.
Sintassi
PFND3DDDI_SETRENDERSTATE Pfnd3dddiSetrenderstate;
HRESULT Pfnd3dddiSetrenderstate(
HANDLE hDevice,
const D3DDDIARG_RENDERSTATE *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in]
Puntatore a una struttura D3DDDIARG_RENDERSTATE che descrive come aggiornare lo stato di rendering.
Valore restituito
SetRenderState restituisce S_OK o un risultato di errore appropriato se lo stato di rendering non viene aggiornato correttamente.
Osservazioni
Il runtime di Microsoft Direct3D esegue il mapping BeginScene e EndScene chiamate dalle applicazioni alla funzione setRenderState del driver di visualizzazione in modalità utente. Quando il runtime riceve una chiamata BeginS cene, imposta il membro State della struttura D3DDDIARG_RENDERSTATE a cui punta D3DRENDERSTATE_SCENECAPTURE D3DRENDERSTATE_SCENECAPTURE pData e il membro Value di D3DDDIARG_RENDERSTATE su TRUE e quindi chiama SetRenderState. Quando il runtime riceve una chiamata EndScene, imposta il membro State su D3DRENDERSTATE_SCENECAPTURE e il membro Value su FALSE e quindi chiama SetRenderState. Tra queste chiamate a SetRenderState, il driver acquisisce i dati geometrici all'interno di un frame.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |