| #define NEXTBAND 3 |
| short Control(lpDevice, NEXTBAND, lpInData, lpBandRect) | |||
| LPPDEVICE lpDevice; | |||
| LPPOINT lpInData; | |||
| LPRECT lpBandRect; |
The NEXTBAND escape informs the device driver that the application has finished writing to a band. The device driver then sends the band to the printer and returns the coordinates of the next band.
lpDevice
Points to a PDEVICE structure specifying the destination device.
lpInData
Points to a POINT structure that receives the horizontal and vertical scaling factors in the x and y members respectively. The POINT structure has the following form:
typedef struct tagPOINT {
short x;
short y;
} POINT;
The shift count in the POINT structure pointed to by the lpInData parameter is used for devices such as laser printers that support graphics at a lower resolution than text.
lpBandRect
Points to a RECT structure that receives the next band coordinates. The device driver copies the device coordinates of the next band into this structure.
The return value is positive if the escape is successful. Otherwise, it is one of the following values.
| Value | Meaning |
| SP_ERROR (-1) | A general error condition or general error in banding occurred. |
| SP_APPABORT (-2) | The job was stopped because the application's callback function returned FALSE (0). |
| SP_USERABORT (-3) | The user stopped the print job by choosing the Delete button from Print Manager. |
| SP_OUTOFDISK (-4) | A lack of disk space caused the job to stop. There is not enough disk space to create or extend the Print Manager temporary file. |
| SP_OUTOFMEMORY (-5) | A lack of memory caused the job to stop. |