Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::CaptureStateBlock

既存のステート ブロック内の値を、デバイスに設定されている値に更新する。

HRESULT CaptureStateBlock(
  DWORD Token
);

パラメータ

Token
[in] デバイス ステートを取り込むステート ブロックへのハンドル。

戻り値

成功した場合は、D3D_OK を返す。

ステート ブロックが現在記録中である場合、メソッドは失敗し、D3DERR_INVALIDCALL を返す。

注意

値 0xFFFFFFFF は、無効なステート ブロック ハンドルである。

このメソッドは、既存のステート ブロックに含まれるステートの更新後の値を取り込む。デバイス全体のステートは取り込まない。

CaptureStateBlock は、ステートブロックの作成後に、明示的または非明示的に作成されたライトの情報を取り込まない。たとえば、現在のステートを D3DSBT_ALL 型のステートブロックに取り込んでも、取り込み後に作成されたライトの情報は保存されない。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::ApplyStateBlockIDirect3DDevice8::BeginStateBlockIDirect3DDevice8::CreateStateBlockIDirect3DDevice8::EndStateBlockIDirect3DDevice8::DeleteStateBlock