IDirect3DMobileDevice::CreateRenderTarget

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.

• ppSurface
  [out] Address of a pointer to an IDirect3DMobileSurface interface.

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

See Also

Reference

IDirect3DMobileDevice
D3DMFORMAT
D3DMMULTISAMPLE_TYPE
IDirect3DMobileDevice::SetRenderTarget
IDirect3DMobileSurface