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