Share via

IDirect3DStateBlock9::Capture

  • [アーティクル]

ステートブロックに含まれているステートの現在の値をキャプチャーします。

HRESULT 
Capture(
);

パラメータ

なし。

戻り値

メソッドが成功した場合は、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 メソッドは、状態ブロックの作成後に明示的または暗黙的に作成されるライトの情報をキャプチャーしません。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容