IDirect3DMobileDevice::CreateImageSurface

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This method creates an image surface.


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

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.

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

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.

Headerd3dm.h
LibraryD3dm.lib, D3dmguid.lib
Windows Embedded CEWindows CE 5.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show: