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

Capture el valor actual de los estados que se incluyen en un bloque de estado.

Sintaxis

HRESULT Capture();

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método porque no se puede realizar la captura mientras está en modo de registro, el valor devuelto es D3DERR_INVALIDCALL.

Comentarios

El método Capture captura los valores actuales de los estados dentro de un bloque de estado existente. No captura todo el estado del dispositivo. Por ejemplo:

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 creación de un bloque de estado vacío y la llamada al método Capture no hace nada si no se han establecido estados.

El método Capture no capturará información de las luces que se crean explícita o implícitamente después de crear el bloqueo de estado.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DStateBlock9