Share via


IDirect3DMobileDevice::ColorFill (Windows CE 5.0)

Send Feedback

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.

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 Values

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

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

See Also

IDirect3DMobileDevice | IDirect3DMobileDevice::Clear | IDirect3DMobileSurface | RECT | D3DMCOLOR

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.