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 |