IDirect3DStateBlock9::Capture メソッド (d3d9helper.h)
stateblock に含まれる状態の現在の値をキャプチャします。
構文
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();
空の stateblock を作成し、Capture メソッドを呼び出しても、状態が設定されていない場合は何も行われません。
Capture メソッドは、ステートブロックの作成後に明示的または暗黙的に作成されたライトの情報をキャプチャしません。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | d3d9helper.h (D3D9.h を含む) |
Library | D3D9.lib |