Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::ApplyStateBlock

既存のデバイス ステート ブロックをレンダリング デバイスに適用する。

HRESULT ApplyStateBlock(
  DWORD Token
);

パラメータ

Token
[in] 実行するデバイス ステート ブロックへのハンドル。これは前に呼び出した IDirect3DDevice8::EndStateBlock メソッドによって返される。

戻り値

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

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

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

アプリケーションで別のブロックを記録しているときに、デバイス ステート ブロックを適用することはできない。

レンダリング デバイスのステートに影響するすべての処理と同様、ステート ブロックの適用は、シーンのレンダリング中、つまり IDirect3DDevice8::BeginScene メソッドを呼び出してから IDirect3DDevice8::EndScene を呼び出すまでの間に行うことを推奨する。

動作環境

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

参照

IDirect3DDevice8::BeginStateBlockIDirect3DDevice8::EndStateBlockIDirect3DDevice8::CaptureStateBlockIDirect3DDevice8::CreateStateBlockIDirect3DDevice8::DeleteStateBlock