IDirect3DMobileSwapChain::Present

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 RECT structure 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 RECT structure 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 hWndDeviceWindow member of D3DMPRESENT_PARAMETERS is 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::Present method.

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

See Also

Reference

IDirect3DMobileSwapChain
D3DMSWAPEFFECT
D3DMPRESENT_PARAMETERS
IDirect3DMobileDevice::Present

Other Resources

RECT