DrvStartBanding

BOOL DrvStartBanding(

IN SURFOBJ *pso,
IN POINTL *pptl
);

DrvStartBanding prepares the driver for banding and returns the origin of the first band.

Parameters

pso

Points to a SURFOBJ structure that describes the banding surface.

pptl

Pointer to the origin of the first band.

Return Value

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

Comments

To actually realize the band contents rendered to the surface identified by pso, DrvNextBand must be called.

The supplied surface must previously have been marked as a banding surface in EngMarkBandingSurface. The size of the band is determined by device and/or driver limitations, and is known only to the driver.

See Also

SURFOBJ