IDirect3DMobileDevice::CreateImageSurface (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

IDirect3DMobileDevice
D3DMFORMAT
IDirect3DMobileSurface
IDirect3DMobileDevice::CopyRects