IDirect3DMobileDevice::CreateRenderTarget (Windows CE 5.0)

Send Feedback

This method creates a render target surface.

HRESULT CreateRenderTarget(  UINT Width,  UINT Height,  D3DMFORMAT Format,  D3DMMULTISAMPLE_TYPE MultiSample,  BOOL Lockable,  IDirect3DMobileSurface** ppSurface);

Parameters

  • Width
    [in] Width of the render target surface, in pixels.
  • Height
    [in] Height of the render target surface, in pixels.
  • Format
    [in] Member of the D3DMFORMAT enumerated type that describes the format of the render target.
  • MultiSample
    [in] Member of the D3DMMULTISAMPLE_TYPE enumerated type that describes the multisampling buffer type. This parameter specifies the antialiasing type for this render target. The type must be the same as that of the depth-stencil buffer when both surfaces are passed to IDirect3DMobileDevice::SetRenderTarget.
  • Lockable
    [in] Render targets are not lockable unless the application specifies TRUE for Lockable. Note that lockable render targets incur a performance cost on some graphics hardware.
  • ppSurface
    [out] Address of a pointer to an IDirect3DMobileSurface interface.

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_MEMORYPOOLEMPTY
  • D3DMERR_INVALIDCAL

Remarks

Render target surfaces are placed in the D3DPOOL_DEFAULT memory class.

Requirements

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

See Also

IDirect3DMobileDevice | D3DMFORMAT | D3DMMULTISAMPLE_TYPE | IDirect3DMobileDevice::SetRenderTarget | IDirect3DMobileSurface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.