Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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::Clearmethod instead. Also, the IDirect3DMobileDevice::ColorFillmethod 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 IDirect3DMobileSurfaceinterface 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 RECTstructure that defines the rectangular region.

Color

[in] A D3DMCOLORvalue 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