Compartilhar via


Método IDirect3DStateBlock9::Capture (d3d9helper.h)

Capture o valor atual dos estados incluídos em um stateblock.

Sintaxe

HRESULT Capture();

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar porque a captura não pode ser feita enquanto estiver no modo de registro, o valor retornado será D3DERR_INVALIDCALL.

Comentários

O método Capture captura valores atuais para estados dentro de um bloco de estado existente. Ele não captura todo o estado do dispositivo. Por exemplo:


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();

Criar um bloco de estado vazio e chamar o método Capture não fará nada se nenhum estado tiver sido definido.

O método Capture não capturará informações para luzes que são criadas explicitamente ou implicitamente após a criação do stateblock.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DStateBlock9