Share via


IDirect3DMobileDevice::ColorFill

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method allows an application to fill a surface with a given pixel color in a given rectangle. Do not use this method to clear the swap chain. You can accomplish this task more effectively by calling the IDirect3DMobileDevice::Clear method instead. Also, the IDirect3DMobileDevice::ColorFill method does not allow the application to fill the depth buffer.

Syntax

HRESULT ColorFill(
  IDirect3DMobileSurface* pSurface,
  CONST RECT* pRect,
  D3DMCOLOR Color
);

Parameters

  • pSurface
    [in] A pointer to an IDirect3DMobileSurface interface representing the surface that will be contain the rectangle. Setting this parameter to NULL fills the entire surface. This surface must be a render target or a render target texture.
  • pRect
    [in] A pointer to a RECT structure that defines the rectangular region.
  • Color
    [in] A D3DMCOLOR value that defines the color to fill the rectangle with.

Return Value

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be D3DERR_INVALIDCALL (see D3DMERR Values).

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

Reference

IDirect3DMobileDevice
IDirect3DMobileDevice::Clear
IDirect3DMobileSurface
D3DMCOLOR

Other Resources

RECT