Share via

IDirect3DMobileDevice::CreateImageSurface

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method creates an image surface.

Syntax

HRESULT CreateImageSurface(
  UINT Width,
  UINT Height,
  D3DMFORMAT Format,
  IDirect3DMobileSurface** ppSurface
);

Parameters

  • Width
    [in] Width of the image surface, in pixels.
  • Height
    [in] Height of the image surface, in pixels.
  • Format
    [in] Member of the D3DMFORMAT enumerated type, describing the format of the image surface.
  • ppSurface
    [out] Address of a pointer to an IDirect3DMobileSurface interface that represents the created image surface.

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

Image surfaces are placeholders, they are surfaces that cannot be used in any Microsoft® Direct3D Mobile® operations except locking and IDirect3DMobileDevice::CopyRects.

Image surfaces are placed in the D3DPOOL_SYSTEMMEM 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
IDirect3DMobileSurface
IDirect3DMobileDevice::CopyRects