Platform SDK: DirectX

IDirect3DDevice7::CaptureStateBlock

IDirect3DDevice7::CaptureStateBlock メソッドは、既存のステート ブロック内の値を、デバイスに現在設定されている値に更新する。

HRESULT CaptureStateBlock(
  DWORD dwBlockHandle 
);

パラメータ

dwBlockHandle
現在のデバイス ステートを取り込むステート ブロックへのハンドル。

戻り値

成功すれば D3D_OK を返す。

失敗すれば、標準のエラー コードを返すか、ステート ブロックの記録中であれば D3DERR_INBEGINSTATEBLOCK を返す。

注意

このメソッドは、既存のステート ブロックに含まれるステートの更新後の値を取り込む。デバイス全体のステートは取り込まない。詳細については、「ステート ブロックの取得」を参照すること。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン :DirectX 7.0 が必要。
  ヘッダー : d3d.h で宣言。

参照

IDirect3DDevice7::ApplyStateBlockIDirect3DDevice7::BeginStateBlockIDirect3DDevice7::CreateStateBlockIDirect3DDevice7::EndStateBlockIDirect3DDevice7::DeleteStateBlockステート ブロックステート ブロックの取得