IDirect3DDevice7::BeginScene

The IDirect3DDevice7::BeginScene method begins a scene. Applications must call this method before performing any rendering and must call IDirect3DDevice7::EndScene when rendering is complete and before calling IDirect3DDevice7::BeginScene again.

HRESULT BeginScene();

Parameters

None.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value is an error. For a complete list of Direct3D Immediate Mode error values and descriptions, see Return Values.

Remarks

If the BeginScene method fails, the device was unable to begin the scene, and there is no need to call the IDirect3DDevice7::EndScene method. In fact, calls to the IDirect3DDevice7::EndScene method will fail if the previous call to BeginScene failed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DDevice7::EndScene, Beginning and Ending a Scene