Metodo IDirect3DDevice9::CreateStateBlock (d3d9helper.h)

Articolo
02/26/2024

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 del blocco di stato. Vedere IDirect3DStateBlock9.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene 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 ai vertici in genere fanno riferimento a tali stati che influiscono sul modo in cui il sistema elabora i vertici. Gli stati correlati ai pixel in genere fanno riferimento agli stati del dispositivo che influiscono sul modo in cui il sistema elabora i dati pixel o depth-buffer 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 dati sullo stato, per gli stati richiesti per l'acquisizione, quando l'oggetto viene creato. Per modificare il valore del blocco di stato, chiamare IDirect3DStateBlock9::Capture o IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. Non viene salvato alcuno stato quando viene creato un oggetto blocco di stato in Direct3D 10.