IDirect3DDevice::BeginScene

The IDirect3DDevice::BeginScene method begins a scene. Applications must call this method before performing any rendering, and must call IDirect3DDevice::EndScene when rendering is complete, and before calling IDirect3DDevice::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.

Remarks

Do not attempt to use GDI functions that use the device context of a render-target surface between calls to BeginScene and EndScene. Attempts to do so can prevent the results of the GDI operations from being visible. If your application uses GDI functions, make sure that all GDI calls are made outside of the scene functions.

QuickInfo

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.

See Also

IDirect3DDevice::EndScene, Beginning and Ending a Scene