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

另请参阅

IDirect3DStateBlock9