short Escape(hdc, NEXTBAND, NULL, NULL,lpBandRect)
The NEXTBAND printer escape informs the device driver that the application has finished writing to a band, causing the device driver to send the band to Print Manager and return the coordinates of the next band. Applications that process banding themselves use this escape.
hdc
HDC Identifies the device context.
lpBandRect
LPRECT Points to the RECT 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. This value is positive if the escape is successful. A return value of zero indicates that an error occurred. In addition, the following error values are defined:
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 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 the NEXTBAND escape.
The NEXTBAND escape should not be used inside metafiles.