Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::BeginStateBlock

Microsoft® Direct3D® にデバイス ステート ブロックの記録を開始するように知らせる。

HRESULT BeginStateBlock();

パラメータ

なし。

戻り値

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

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

D3DERR_INVALIDCALL
E_OUTOFMEMORY

注意

アプリケーションでは、このメソッドを呼び出す前に IDirect3DDevice8::ValidateDevice メソッドを呼び出して、記録するすべてのステートが有効であることを確認できる。

BeginStateBlock を呼び出してから IDirect3DDevice8::EndStateBlock を呼び出すまでにステート ブロックに記録できるメソッドは、次のとおりである。

ステート ブロック内では、ステート変更の順序は保証されない。ステート ブロックで同じステートが複数回指定された場合、使用されるのは最後の値のみである。

動作環境

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

参照

IDirect3DDevice8::ApplyStateBlockIDirect3DDevice8::EndStateBlockIDirect3DDevice8::CaptureStateBlockIDirect3DDevice8::CreateStateBlockIDirect3DDevice8::DeleteStateBlock