Metodo IDirect3DDevice9::CreateStateBlock (d3d9.h)
Crea un nuovo blocco di stato che contiene i valori per tutti gli stati del dispositivo, gli stati correlati ai vertici o gli stati correlati ai pixel.
Sintassi
HRESULT CreateStateBlock(
[in] D3DSTATEBLOCKTYPE Type,
[out, retval] IDirect3DStateBlock9 **ppSB
);
Parametri
[in] Type
Tipo: D3DSTATEBLOCKTYPE
Tipo di dati di stato che il metodo deve acquisire. Questo parametro può essere impostato su un valore definito nel tipo enumerato D3DSTATEBLOCKTYPE .
[out, retval] ppSB
Tipo: IDirect3DStateBlock9**
Puntatore a un'interfaccia a blocchi di stato. Vedere IDirect3DStateBlock9.
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.
Commenti
Gli stati dei dispositivi correlati al vertice fanno in genere riferimento a questi stati che influiscono sul modo in cui i vertici del sistema elaborano i vertici. Gli stati correlati ai pixel fanno in genere riferimento agli stati del dispositivo che influiscono sul modo in cui il sistema elabora i dati del pixel o del buffer di profondità durante la rasterizzazione. Alcuni stati sono contenuti in entrambi i gruppi.
|
Differenze tra Direct3D 9 e Direct3D 10: In Direct3D 9, un blocco di stato contiene i dati sullo stato, per gli stati richiesti per l'acquisizione, al momento della creazione dell'oggetto. Per modificare il valore del blocco di stato, chiamare IDirect3DStateBlock9::Capture o IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. Non è stato salvato quando viene creato un oggetto blocco di stato in Direct3D 10. |
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9.h (includere D3D9.h) |
| Libreria | D3D9.lib |