IDirect3DStateBlock9::Capture 方法 (d3d9helper.h)
捕获状态块中包含的状态的当前值。
语法
HRESULT Capture();
返回值
类型: HRESULT
如果该方法成功,则返回值D3D_OK。 如果方法由于在记录模式下无法执行捕获而失败,则返回值D3DERR_INVALIDCALL。
注解
Capture 方法捕获现有状态块中状态的当前值。 它不会捕获设备的整个状态。 例如:
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();
如果未设置任何状态,则创建空状态块并调用 Capture 方法不执行任何操作。
Capture 方法不会捕获在创建状态块后显式或隐式创建的光的信息。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d3d9helper.h (包括 D3D9.h) |
Library | D3D9.lib |