IDirect3DMobileDevice::CreateRenderTarget

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method creates a render target surface.

Syntax

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.

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

Remarks

Render target surfaces are placed in the D3DPOOL_DEFAULT memory class.

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

IDirect3DMobileDevice
D3DMFORMAT
D3DMMULTISAMPLE_TYPE
IDirect3DMobileDevice::SetRenderTarget
IDirect3DMobileSurface