Partager via

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

  • Article

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

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DStateBlock9