DrvPaint (Compact 2013)

3/26/2014

This function is obsolete, and is no longer called by GDI. To replace the functionality, implement one or more of DrvFillPath, DrvStrokePath, and DrvStrokeAndFillPath.

Syntax

BOOL DrvPaint(
  SURFOBJ* pso,
  CLIPOBJ* pco,
  BRUSHOBJ* pbo,
  POINTL* pptlBrushOrg,
  MIX mix
);

Parameters

• pso
  [in] Pointer to the SURFOBJ structure that describes the surface on which to draw.

• pco
  [in] Pointer to a CLIPOBJ structure that limits the area to be modified. The GDI CLIPOBJ_XXX functions enumerate the clip region as a set of rectangles. Whenever possible, GDI simplifies the clipping involved; for example, this function is never called with a single clipping rectangle. GDI clips the destination rectangle before calling this function, making additional clipping unnecessary.

• pbo
  [in] Pointer to the brush object that defines the pattern for the bit-block transfer. GDI's BRUSHOBJ_pvGetRbrush function can be used to retrieve the device's realization of the brush. This parameter is ignored if the rop4 parameter does not require a pattern.

• pptlBrushOrg
  [in] Pointer to a POINTL structure that defines the origin of the brush in the destination surface. The upper left pixel of the brush is aligned at this point, and the brush repeats according to its dimensions. This parameter is ignored if the rop4 parameter does not require a pattern.

• mix
  [in] Raster operation that defines how the pattern and destination pixels combine to write to the destination surface.

  Mix modes define how GDI combines source and destination colors when drawing with the current pen. The mix modes are binary raster operation codes, representing all possible Boolean functions of two variables, using the binary operations AND, OR, and XOR, and the unary operation NOT.

Return Value

TRUE if the paint operation is successful. Otherwise, the function returns FALSE, and an error code is logged.

Remarks

GDI calls this function when it needs to perform a PaintRgn or FillRgn operation, or fill complex clipped polygons.

Requirements

See Also

Reference

Display Driver Functions

Other Resources

FillRgn