DrvNextBand

BOOL DrvNextBand(

    IN SURFOBJ  *pso,
   IN POINTL  *pptl
  );

DrvNextBand realizes the contents of the band just drawn on the specified surface and returns the origin of the next band.

Parameters

pso

Points to a SURFOBJ structure that describes the banding surface.

pptl

Pointer to POINTL structure in which the origin of the next band is returned.

Return Value

DrvNextBand returns TRUE if it succeeds; otherwise, it returns FALSE.

Comments

Calls to DrvNextBand should only be made after an initial call to DrvStartBanding. DrvNextBand returns (-1,-1) in pptl when the end of a page or document is encountered.

The supplied surface must have been previously marked as a banding surface in EngMarkBandingSurface.

See Also

SURFOBJ