IDirect3DDevice9::CreateStateBlock メソッド

  • [アーティクル]

IDirect3DDevice9::CreateStateBlock メソッド

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

構文

HRESULT CreateStateBlock(      
    D3DSTATEBLOCKTYPE Type,
    IDirect3DStateBlock9** ppSB
);

パラメータ

  • Type
    [in] メソッドで取り込むステート データの種類。このパラメータには、D3DSTATEBLOCKTYPE 列挙型で定義されている値を設定できる。
  • ppSB
    [out, retval] ステート ブロック インターフェイスへのポインタ。

戻り値

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

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。
D3DERR_OUTOFVIDEOMEMORY Microsoft® Direct3D® が処理を行うのに十分なディスプレイ メモリがない。
E_OUTOFMEMORY Direct3D が呼び出しを完了するための十分なメモリを割り当てることができなかった。

注意

頂点関連のデバイス ステートとは、一般には、システムによる頂点の処理方法に影響するステートをいう。ピクセル関連のステートとは、通常、ラスタ化の際のシステムによるピクセルまたは深度バッファの処理方法に影響するデバイス ステートのことである。一部のステートは両方のグループに属する。

参照

IDirect3DDevice9::BeginStateBlock、IDirect3DDevice9::EndStateBlock