short Escape(hDC, NEXTBAND,NULL, NULL, lpBandRect)
This escape informs the device driver that the application has finished writing to a band, causing the device driver to send the band to the Print Manager and return the coordinates of the next band. Applications that process banding themselves use this escape.
Parameter | Type/Description |
hDC | HDC Identifies the device context. | |
lpBandRect | LPRECT Points to the RECT data structure that will receive the next band coordinates. The device driver copies the device coordinates of the next band into this structure. |
The return value specifies the outcome of the escape. It is positive if the escape is successful. Otherwise, it is one of the following values:
Value | Meaning |
SP_APPABORT | Job was terminated because the application's abort function returned zero. | |
SP_ERROR | General error. | |
SP_OUTOFDISK | Not enough disk space is currently available for spooling, and no more space will become available. | |
SP_OUTOFMEMORY | Not enough memory is available for spooling. | |
SP_USERABORT | User terminated the job through the Print Manager. |
The NEXTBAND escape sets the band rectangle to the empty rectangle when printing reaches the end of a page.
Do not use the NEWFRAME escape with NEXTBAND.