DrvGradientFill (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function translates between device-managed raster surfaces and graphics device interface (GDI) standard format bitmaps.

BOOL DrvGradientFill(
  SURFOBJ* pso,
  CLIPOBJ* pco,
  XLATEOBJ* pxlo,
  TRIVERTEX* pVertex,
  ULONG nVertex,
  PVOID pMesh,
  ULONG nMesh,
  RECTL* prclExtents,
  POINTL* pptlDitherOrg, 
  ULONG ulMode


[out] Pointer to the destination surface for the gradient fill operation.
[in] Pointer to a CLIPOBJ structure that defines a clipping region on the destination surface.
[in] Pointer to a XLATEOBJ structure that defines the translation of color indices between the source and target surfaces.
[in] Pointer to an array of TRIVERTEX structures, each of which defines a triangle vertex.
[in] Number of vertices in the pVertex parameter.
[in] Array of GRADIENT_RECT structures in rectangle mode.
[in] Number of rectangles in the pMesh parameter.
[in] Pointer to a RECTL structure that defines the area to modify. This structure uses the coordinate system of the destination surface. The bottom and right edges of this rectangle are not part of the blit; that is, the rectangle is bottom-right exclusive.
[in] Pointer to a POINTL structure that defines the upper-left corner of the destination surface.
[in] Gradient fill mode. The following table shows the possible values for the ulMode parameter.
GRADIENT_FILL_RECT_HTwo endpoints describe a rectangle. The rectangle is defined to have a constant color, specified by the TRIVERTEX structure, for the left and right edges. GDI interpolates the color from the left-to-right edge and fills the interior.
GRADIENT_FILL_RECT_VTwo endpoints describe a rectangle. The rectangle is defined to have a constant color, specified by the TRIVERTEX structure, for the top and bottom edges. GDI interpolates the color from the top-to-bottom edge and fills the interior.

Return Values

TRUE indicates success. FALSE indicates failure.


Set SYSGEN_GRADFILL for the GradientFill function to be available to GDI. __SYSGEN_GPE_GRADFILL is set automatically when you set SYSGEN_GRADFILL. If the display driver is not GPE-based, the display driver has to export the DrvGradientFill function, and set SYSGEN_GRADFILL.


OS Versions: Windows CE .NET 4.2 and later.
Header: Winddi.h
Link Library: Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.

See Also

Display Drivers | GradientFill | GRADIENT_RECT | RECTL | TRIVERTEX | XLATEOBJ

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.