Platform SDK: DirectX

ID3DXContext::UpdateFrame

The ID3DXContext::UpdateFrame method updates a frame using either page flipping or blitting.

HRESULT UpdateFrame(
  DWORD flags
); 

Parameters

flags
A flag specifying frame update options. See Remarks.

Return Values

If the method succeeds, the return value is S_OK.

If the method fails, the return value may be one of the following values:

DDERR_DCALREADYCREATED
DDERR_GENERIC
DDERR_IMPLICITLYCREATED
DDERR_INCOMPATIBLEPRIMARY
DDERR_INVALIDCLIPLIST
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_INVALIDSURFACETYPE
DDERR_NOALPHAHW
DDERR_NOBLTHW
DDERR_NOCLIPLIST
DDERR_NODDROPSHW
DDERR_NOEXCLUSIVEMODE
DDERR_NOFLIPHW
DDERR_NOTFLIPPABLE
DDERR_NOMIRRORHW
DDERR_NORASTEROPHW
DDERR_NOROTATIONHW
DDERR_NOSTRETCHHW
DDERR_NOZBUFFERHW
DDERR_OUTOFMEMORY
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING
DDERR_WRONGMODE

Remarks

If the D3DX_UPDATE_NOVSYNC flag is set in the flags parameter, a blit is used if the driver cannot flip without waiting for vertical synchronization (vsync) in full-screen mode.

For more information, see Flipping Surfaces.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxcore.h.
  Library: Use d3dx.lib.

See Also

IDirectDrawSurface7::Blt, IDirectDrawSurface7::Flip