SplPdNewPage: Difference between revisions
Created page with "SplPdNewPage is an API exported by port drivers. It is called by PrtNewPage to signal the beginning of a new output page. This call is issued for the first page in a job with ..." |
No edit summary |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
SplPdNewPage is an API exported by port drivers. It is called by PrtNewPage to signal the beginning of a new output page. This call is issued for the first page in a job with page number 1, to signal the spooler that the port driver can determine print job page boundaries. | SplPdNewPage is an API exported by port drivers. It is called by [[PrtNewPage]] to signal the beginning of a new output page. This call is issued for the first page in a job with page number 1, to signal the spooler that the port driver can determine print job page boundaries. | ||
== Syntax == | == Syntax == | ||
SplPdNewPage(hDevice, ulPageNumber) | SplPdNewPage(hDevice, ulPageNumber) | ||
== Parameters == | == Parameters == | ||
; hDevice (HFILE) - input | ;''hDevice'' ([[HFILE]]) - input:Handle from [[SplPdOpen]]. | ||
: Handle from SplPdOpen. | ;''ulPageNumber'' ([[ULONG]]) - input:The new page number. | ||
; | == Returns == | ||
: | ;''rc'' ([[ULONG]]) - returns: Return codes. | ||
*0 Success | |||
*6 (ERROR_INVALID_HANDLE) : Invalid handle given. | |||
== | == Remarks == | ||
This call might not be issued for raw jobs. Some printer drivers might not be able to determine page breaks for raw print jobs. | |||
== Sample == | == Sample == | ||
| Line 28: | Line 28: | ||
rc = SplPdNewPage(hDevice, ulPageNumber); | rc = SplPdNewPage(hDevice, ulPageNumber); | ||
</pre> | </pre> | ||
[[Category:Spl]] | [[Category:Spl]] | ||
Latest revision as of 04:26, 3 September 2025
SplPdNewPage is an API exported by port drivers. It is called by PrtNewPage to signal the beginning of a new output page. This call is issued for the first page in a job with page number 1, to signal the spooler that the port driver can determine print job page boundaries.
Syntax
SplPdNewPage(hDevice, ulPageNumber)
Parameters
Returns
- rc (ULONG) - returns
- Return codes.
- 0 Success
- 6 (ERROR_INVALID_HANDLE) : Invalid handle given.
Remarks
This call might not be issued for raw jobs. Some printer drivers might not be able to determine page breaks for raw print jobs.
Sample
#define INCL_SPL #define INCL_SPLBIDI #include <os2.h> HFILE hDevice; /* Handle from SplPdOpen. */ ULONG ulPageNumber; /* The new page number. */ ULONG rc; /* Return codes. */ rc = SplPdNewPage(hDevice, ulPageNumber);