IDirect3DDevice9::CreateStateBlock メソッド (d3d9helper.h)

[アーティクル]
02/26/2024

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

構文

HRESULT CreateStateBlock(
  [in]          D3DSTATEBLOCKTYPE    Type,
  [out, retval] IDirect3DStateBlock9 **ppSB
);

パラメーター

[in] Type

種類: D3DSTATEBLOCKTYPE

メソッドがキャプチャする必要がある状態データの種類。このパラメーターは、 D3DSTATEBLOCKTYPE 列挙型で定義されている値に設定できます。

[out, retval] ppSB

種類: IDirect3DStateBlock9**

状態ブロックインターフェイスへのポインター。「IDirect3DStateBlock9」を参照してください。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

注釈

頂点関連のデバイスの状態は、通常、システムが頂点を処理する方法に影響を与える状態を指します。ピクセル関連の状態は、通常、ラスター化中にシステムがピクセルまたは深度バッファーデータを処理する方法に影響を与えるデバイスの状態を指します。一部の状態は両方のグループに含まれています。

Direct3D 9 と Direct3D 10 の違い:

Direct3D 9 では、状態ブロックには、オブジェクトの作成時にキャプチャが要求された状態の状態データが含まれます。状態ブロックの値を変更するには、 IDirect3DStateBlock9::Capture または IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock を呼び出します。 Direct3D 10 で状態ブロックオブジェクトが作成されたときに保存された状態はありません。