Condividi tramite


Funzione D3D10CreateStateBlock (d3d10effect.h)

Creare un blocco di stato.

Sintassi

HRESULT D3D10CreateStateBlock(
  [in]  ID3D10Device           *pDevice,
  [in]  D3D10_STATE_BLOCK_MASK *pStateBlockMask,
  [out] ID3D10StateBlock       **ppStateBlock
);

Parametri

[in] pDevice

Tipo: ID3D10Device*

Dispositivo per il quale verrà creato il blocco di stato.

[in] pStateBlockMask

Tipo: D3D10_STATE_BLOCK_MASK*

Indica quali parti dello stato del dispositivo verranno acquisite durante la chiamata a ID3D10StateBlock::Capture e riapplicate quando si chiama ID3D10StateBlock::Apply. Vedere la sezione Osservazioni.

[out] ppStateBlock

Tipo: ID3D10StateBlock**

Indirizzo di un puntatore al buffer creato (vedere l'interfaccia ID3D10StateBlock).

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 10 seguenti.

Commenti

Un blocco di stato è una raccolta di stato del dispositivo e viene usato per salvare e ripristinare lo stato del dispositivo. Usare una maschera a blocchi di stato per abilitare subset di stato per il salvataggio e il ripristino.

La struttura D3D10_STATE_BLOCK_MASK può essere riempita manualmente o usando una qualsiasi delle API D3D10StateBlockMaskXXX. È anche possibile ottenere una maschera di blocco di stato chiamando ID3D10EffectTechnique::ComputeStateBlockMask o ID3D10EffectPass::ComputeStateBlockMask.

Differenze tra Direct3D 9 e Direct3D 10:

In Direct3D 10, un oggetto blocco di stato non contiene informazioni valide sullo stato del dispositivo finché non viene chiamato ID3D10StateBlock::Capture . In Direct3D 9 lo stato viene salvato in un oggetto blocco di stato, quando viene creato.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione d3d10effect.h
Libreria D3D10.lib
DLL D3D10.dll

Vedi anche

Funzioni di sistema

Funzioni effetto