IDirect3DMobileSwapChain::Present
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 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
| 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
Reference
IDirect3DMobileSwapChain
D3DMSWAPEFFECT
D3DMPRESENT_PARAMETERS
IDirect3DMobileDevice::Present