Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method presents the contents of the next in the sequence of back buffers owned by the swap chain.

Syntax 

HRESULT Present(
  CONST RECT* 
pSourceRect,
  CONST RECT* 
pDestRect,
  HWND 
hDestWindowOverride,
  CONST RGNDATA* 
pDirtyRegion
);

Parameters

pSourceRect

[in] Pointer to a RECTstructure that contains the source rectangle. This value must be NULL unless the swap chain was created with D3DMSWAPEFFECT_COPY or D3DMSWAPEFFECT_COPY_VSYNC (see D3DMSWAPEFFECT). If NULL, the entire source surface is presented. If the rectangle exceeds the source surface, the rectangle is clipped to the source surface.

pDestRect

[in] Pointer to a RECTstructure containing the destination rectangle, in window client coordinates. This value must be NULL unless the swap chain was created with D3DMSWAPEFFECT_COPY or D3DMSWAPEFFECT_COPY_VSYNC. If NULL, the entire client area is filled. If the rectangle exceeds the destination client area, the rectangle is clipped to the destination client area.

hDestWindowOverride

[in] Destination window whose client area is taken as the target for this presentation. If this value is NULL, the hWndDeviceWindowmember of D3DMPRESENT_PARAMETERSis taken.

pDirtyRegion

[in] This parameter is not used and must be set to NULL.

Return Value

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be E_OUTOFMEMORY or one of the following D3DMERR Values.

  • D3DMERR_INVALIDCALL

  • D3DMERR_MEMORYPOOLEMPTY

Remarks

This method performs identically to the IDirect3DMobileDevice::Presentmethod.

If necessary, a stretch operation is applied to transfer the pixels within the source rectangle to the destination rectangle in the client area of the target window.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also