Share via

IDirect3DMobileSwapChain::Present (Windows CE 5.0)

  • Article

Send Feedback

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

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 Values

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 theIDirect3DMobileDevice::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

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobileSwapChain | RECT | D3DMSWAPEFFECT | D3DMPRESENT_PARAMETERS | IDirect3DMobileDevice::Present

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.