Platform SDK: DirectX

IDirect3DDevice7::BeginStateBlock

IDirect3DDevice7::BeginStateBlock メソッドは、Direct3D にデバイス ステート ブロックの記録を開始するように知らせる。

HRESULT BeginStateBlock();

パラメータ

なし。

戻り値

成功すれば D3D_OK を返す。

失敗すれば、次のいずれかの値を返す。

D3DERR_INBEGINSTATEBLOCK
DDERR_OUTOFMEMORY

注意

このメソッドは IDirect3DDevice7 インターフェイスと共に導入された。

アプリケーションでは、このメソッドを呼び出す前に IDirect3DDevice7::ValidateDevice メソッドを呼び出して、記録するすべてのステートが有効であることを確認できる。

ステート ブロック (IDirect3DDevice7::BeginStateBlock を呼び出してから IDirect3DDevice7::EndStateBlock を呼び出すまで) に記録できるメソッドは以下のとおりである。

ステート ブロック内では、ステート変更の順序は保証されない。ステート ブロックで同じステートが複数回指定された場合、使用されるのは最後の値のみである。

動作環境

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

参照

IDirect3DDevice7::ApplyStateBlockIDirect3DDevice7::EndStateBlockIDirect3DDevice7::CaptureStateBlockIDirect3DDevice7::CreateStateBlockIDirect3DDevice7::DeleteStateBlockステート ブロック