| #define NEWFRAME 1 |
| short Control(lpDevice, NEWFRAME, NULL, NULL) | |||
| LPPDEVICE lpDevice; |
The NEWFRAME escape informs the device that the application has finished writing to a page. This escape is used typically with a printer to direct the device driver to advance to a new page by performing a page-break algorithm or form feed.
lpDevice
Points to a PDEVICE structure specifying the destination device.
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. |