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
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |