Metodo IDirect3DStateBlock9::Capture (d3d9helper.h)

Acquisire il valore corrente degli stati inclusi in un blocco di stato.

Sintassi

HRESULT Capture();

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo perché l'acquisizione non può essere eseguita durante la modalità record, il valore restituito è D3DERR_INVALIDCALL.

Commenti

Il metodo Capture acquisisce i valori correnti per gli stati all'interno di un blocco di stato esistente. Non acquisisce l'intero stato del dispositivo. Ad esempio:

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 creazione di un blocco di stato vuoto e la chiamata al metodo Capture non fa nulla se non sono stati impostati stati.

Il metodo Capture non acquisisce informazioni per le luci create in modo esplicito o implicito dopo la creazione del blocco stato.

Requisiti

Vedi anche

IDirect3DStateBlock9