Microsoft DirectX 8.0 (C++) |
既存のステート ブロック内の値を、デバイスに設定されている値に更新する。
HRESULT CaptureStateBlock( DWORD Token );
成功した場合は、D3D_OK を返す。
ステート ブロックが現在記録中である場合、メソッドは失敗し、D3DERR_INVALIDCALL を返す。
値 0xFFFFFFFF は、無効なステート ブロック ハンドルである。
このメソッドは、既存のステート ブロックに含まれるステートの更新後の値を取り込む。デバイス全体のステートは取り込まない。
CaptureStateBlock は、ステートブロックの作成後に、明示的または非明示的に作成されたライトの情報を取り込まない。たとえば、現在のステートを D3DSBT_ALL 型のステートブロックに取り込んでも、取り込み後に作成されたライトの情報は保存されない。
ヘッダー : d3d8.h で宣言。
インポート ライブラリ : D3d8.lib を使用。
IDirect3DDevice8::ApplyStateBlock、IDirect3DDevice8::BeginStateBlock、IDirect3DDevice8::CreateStateBlock、IDirect3DDevice8::EndStateBlock、IDirect3DDevice8::DeleteStateBlock