Expand Minimize

IDirect3DDevice9::Present method

Presents the contents of the next buffer in the sequence of back buffers owned by the device.

Syntax


HRESULT Present(
  [in]  const RECT *pSourceRect,
  [in]  const RECT *pDestRect,
  [in]  HWND hDestWindowOverride,
  [in]  const RGNDATA *pDirtyRegion
);

Parameters

pSourceRect [in]

Type: const RECT*

Pointer to a value that must be NULL unless the swap chain was created with D3DSWAPEFFECT_COPY. pSourceRect is a pointer to a RECT structure containing the source rectangle. 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]

Type: const RECT*

Pointer to a value that must be NULL unless the swap chain was created with D3DSWAPEFFECT_COPY. pDestRect is a pointer to a RECT structure containing the destination rectangle, in window client coordinates. 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]

Type: HWND

Pointer to a destination window whose client area is taken as the target for this presentation. If this value is NULL, the runtime uses the hDeviceWindow member of D3DPRESENT_PARAMETERS for the presentation.

pDirtyRegion [in]

Type: const RGNDATA*

Value must be NULL unless the swap chain was created with D3DSWAPEFFECT_COPY. For more information about swap chains, see Flipping Surfaces (Direct3D 9) and D3DSWAPEFFECT. If this value is non-NULL, the contained region is expressed in back buffer coordinates. The rectangles within the region are the minimal set of pixels that need to be updated. This method takes these rectangles into account when optimizing the presentation by copying only the pixels within the region, or some suitably expanded set of rectangles. This is an aid to optimization only, and the application should not rely on the region being copied exactly. The implementation can choose to copy the whole source rectangle.

Return value

Type: HRESULT

Possible return values include: D3D_OK or D3DERR_DEVICEREMOVED (see D3DERR).

Remarks

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.

Present will fail, returning D3DERR_INVALIDCALL, if called between BeginScene and EndScene pairs unless the render target is not the current render target (such as the back buffer you get from creating an additional swap chain). This is a new behavior for Direct3D 9.

Requirements

Header

D3D9.h

Library

D3D9.lib

See also

IDirect3DDevice9
Reset
Multihead (Direct3D 9)
Lost Devices (Direct3D 9)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.