Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::CreateStateBlock

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

HRESULT CreateStateBlock(
  D3DSTATEBLOCKTYPE Type,
  DWORD* pToken
);

パラメータ

Type
[in] メソッドで取り込むステート データの種類。このパラメータには、D3DSTATEBLOCKTYPE 列挙型で定義されている値を設定できる。
pToken
[out, retval] メソッドが成功した場合にステート ブロックのハンドルを格納する DWORD 値へのポインタ。

戻り値

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

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

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

注意

値 0xFFFFFFFF は、無効なステート ブロック ハンドルである。

頂点関連のデバイス ステートとは、一般にはシステムの頂点の処理方法に影響するステートをいう。ピクセル関連のステートとは、ラスタ化におけるシステムのピクセルまたは深度バッファの処理方法に影響するデバイス ステートをいう。ステートによっては両方に属する場合もある。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::ApplyStateBlockIDirect3DDevice8::BeginStateBlockIDirect3DDevice8::CaptureStateBlockIDirect3DDevice8::EndStateBlockIDirect3DDevice8::DeleteStateBlock