IDirect3DDevice8::CreateImageSurface

This method creates an image surface.

HRESULT CreateImageSurface(
  UINT Width,
  UINT Height,
  D3DFORMAT Format,
  IDirect3DSurface8** 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 D3DFORMAT enumerated type, describing the format of the image surface.
• ppSurface
  [out, retval] Address of a pointer to an IDirect3DSurface8 interface, representing the created image surface.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

• D3DERR_INVALIDCALL
• D3DERR_OUTOFVIDEOMEMORY
• E_OUTOFMEMORY

Remarks

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

Image surfaces are placed in the D3DPOOL_SYSTEMMEM memory class.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

D3DFORMAT | IDirect3DSurface8 | IDirect3DDevice8::CopyRects | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.