IDirect3DDevice9::CreateStateBlock メソッド (d3d9.h)
すべてのデバイス状態、頂点関連の状態、またはピクセル関連の状態の値を含む新しい状態ブロックを作成します。
構文
HRESULT CreateStateBlock(
[in] D3DSTATEBLOCKTYPE Type,
[out, retval] IDirect3DStateBlock9 **ppSB
);
パラメーター
[in] Type
メソッドがキャプチャする必要がある状態データの種類。 このパラメーターは、 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 で状態ブロック オブジェクトが作成されたときに保存された状態はありません。 |
要件
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3D9.lib |