Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 D3DMFORMATenumerated type, describing the format of the image surface.

ppSurface

[out] Address of a pointer to an IDirect3DMobileSurfaceinterface 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