Share via

IDirect3DDevice9::BeginScene メソッド

  • [アーティクル]

IDirect3DDevice9::BeginScene メソッド

シーンを開始する。

構文

HRESULT BeginScene(VOID);

戻り値

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

既に BeginScene/EndScene ペアのときに BeginScene が呼び出された場合、このメソッドは失敗して D3DERR_INVALIDCALL を返す。これは、EndScene を呼び出さずに BeginScene を 2 度呼び出した場合のみ発生する。

注意

アプリケーションでは、レンダリングを実行する前には必ずこのメソッドを呼び出し、レンダリングの終了時および再度 IDirect3DDevice9::BeginScene を呼び出す前には、必ず IDirect3DDevice9::EndScene を呼び出す。

IDirect3DDevice9::BeginScene メソッドが失敗すると、デバイスはシーンを開始できないため、IDirect3DDevice9::EndScene メソッドを呼び出す必要はない。実際、その前の IDirect3DDevice9::BeginScene の呼び出しが失敗すると、IDirect3DDevice9::EndScene の呼び出しも失敗する。

参照

IDirect3DDevice9::EndScene