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 の呼び出しも失敗する。
参照