Platform SDK: DirectX

IDirect3DDevice7::ApplyStateBlock

IDirect3DDevice7::ApplyStateBlock メソッドは、既存のデバイス ステート ブロックをレンダリング デバイスに適用する。

HRESULT ApplyStateBlock( 
  DWORD dwBlockHandle 
); 

パラメータ

dwBlockHandle
実行するデバイス ステート ブロックへのハンドル。これは前に呼び出した IDirect3DDevice7::EndStateBlock メソッドによって返される。

戻り値

成功すれば D3D_OK を返す。

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

D3DERR_INBEGINSTATEBLOCK
D3DERR_INVALIDVERTEXTYPE

注意

アプリケーションで別のブロックを記録しているときに、デバイス ステート ブロックを適用することはできない。

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

レンダリング デバイスのステートに影響するすべての処理と同様、ステート ブロックの適用は、シーンのレンダリング中、つまり IDirect3DDevice7::BeginScene メソッドを呼び出してから IDirect3DDevice7::EndScene を呼び出すまでの間に行うことを推奨する。

動作環境

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

参照

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