Platform SDK: DirectX

IDirect3DDevice7::CreateStateBlock

IDirect3DDevice7::CreateStateBlock メソッドは、すべてのデバイス ステート、頂点関連のステート、またはピクセル関連のステートの現在の値を含む新しいステート ブロックを作成する。

HRESULT CreateStateBlock( 
  D3DSTATEBLOCKTYPE d3dsbType, 
  LPDWORD lpdwBlockHandle
); 
 

パラメータ

d3dsbType
メソッドで取り込むステート データの種類。このパラメータは、D3DSTATEBLOCKTYPE 列挙型に定義される値のいずれかに設定する。
lpdwBlockHandle
メソッドが成功した場合に、ステート ブロックのハンドルを格納する変数のアドレス。

戻り値

成功すれば D3D_OK を返す。

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

D3DERR_INBEGINSTATEBLOCK
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

注意

頂点関連のデバイス ステートとは、一般にはシステムの頂点の処理方法に影響するステートをいう。ピクセル関連のステートとは、ラスタ化におけるシステムのピクセルまたは深度バッファの処理方法に影響するデバイス ステートをいう。ステートによっては両方に属する場合もある。個々のステートの詳細については、「事前定義するステート ブロックの作成」を参照すること。

動作環境

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

参照

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