Méthode IDirect3DStateBlock9 ::Capture (d3d9.h)

Capturez la valeur actuelle des états inclus dans un stateblock.

Syntaxe

HRESULT Capture();

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, car la capture ne peut pas être effectuée en mode enregistrement, la valeur de retour est D3DERR_INVALIDCALL.

Remarques

La méthode Capture capture les valeurs actuelles pour les états au sein d’un bloc d’état existant. Il ne capture pas l’état entier de l’appareil. Par exemple :

IDirect3DStateBlock9* pStateBlock = NULL;

pd3dDevice->BeginStateBlock();
// Add the ZENABLE state to the stateblock 
pd3dDevice->SetRenderState ( D3DRS_ZENABLE, D3DZB_TRUE );
pd3dDevice->EndStateBlock ( &pStateBlock );
    
// Change the current value that is stored in the state block
pd3dDevice->SetRenderState ( D3DRS_ZENABLE, D3DZB_FALSE );
pStateBlock->Capture();			

pStateBlock->Release();

La création d’un bloc d’état vide et l’appel de la méthode Capture ne fait rien si aucun état n’a été défini.

La méthode Capture ne capture pas d’informations pour les lumières qui sont créées explicitement ou implicitement après la création du stateblock.

Configuration requise

Voir aussi

IDirect3DStateBlock9