DrvStrokePath (Compact 2013)

3/26/2014

This function strokes a path when called by GDI.

Syntax

BOOL DrvStrokePath(
  SURFOBJ* pso,
  PATHOBJ* ppo,
  CLIPOBJ* pco,
  XFORMOBJ* pxo,
  BRUSHOBJ* pbo,
  POINTL* pptlBrushOrg,
  LINEATTRS* plineattrs,
  MIX mix
);

Parameters

• pso
  [in] Surface on which to draw.

• ppo
  [in] Pointer to a PATHOBJ structure. GDI PATHOBJ_XXX functions enumerate the lines, Bezier curves, and other data that constitutes the path. This indicates what is to be drawn.

• pco
  [in] Pointer to a CLIPOBJ structure. GDI CLIPOBJ_XXX functions are provided to enumerate the clip region as a set of rectangles. Optionally, all the lines in the path may be enumerated preclipped by CLIPOBJ. This means that drivers can have all their line clipping calculations done for them.

• pxo
  [in] Pointer to a XFORMOBJ structure. This is needed only when a geometric wide line is to be drawn. It specifies the transform that maps world coordinates to device coordinates. This is needed because the path is provided in device coordinates but a geometric wide line is actually widened in world coordinates.

  Query the XFORMOBJ structure to find the transform.

• pbo
  [in] Brush to use when drawing the path.

• pptlBrushOrg
  [in] Pointer to the brush origin used to align the brush pattern on the device.

• plineattrs
  [in] Pointer to a LINEATTRS structure. The elStyleState member of this structure must be updated as part of this function if the line is styled. The ptlLastPel member must be updated if a single pixel width cosmetic line is being drawn.

• mix
  [in] MIX structure that defines the foreground and background raster operations to use for the brush.

Return Value

TRUE if the driver is able to stroke the path. If GDI should stroke the path, the return value is FALSE, and an error code is not logged. If the driver encounters an error, the return value is DDI_ERROR, and an error code is reported.

Remarks

The mix mode defines how the incoming pattern mixes with the data already on the device surface. The MIX data type consists of two ROP2 values packed into a single ULONG. The low-order byte defines the foreground raster operation; the high-order byte defines the background raster operation.

Requirements

See Also

Reference

Display Driver Functions
DrvFillPath