Share via


IDirect3DMobileDevice::CreateImageSurface (Windows CE 5.0)

Send Feedback

This method creates an image surface.

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 Values

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

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobileDevice | D3DMFORMAT | IDirect3DMobileSurface | IDirect3DMobileDevice::CopyRects

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.