Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.CaptureStateBlock

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

object.CaptureStateBlock( _ 
    Token As Long)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
Token
デバイス ステートを取り込むステート ブロックへのハンドル。

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

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

このメソッドは、既存のステート ブロックに、更新されたステートの値をキャプチャする。デバイスのステート全体をキャプチャするのではない。

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

参照

Direct3DDevice8.ApplyStateBlockDirect3DDevice8.BeginStateBlockDirect3DDevice8.CreateStateBlockDirect3DDevice8.EndStateBlockDirect3DDevice8.DeleteStateBlock