描述
StartDocPrinter功能通知打印后台处理程序要将假脱机文档进行打印。
C++ 语法
DWORD StartDocPrinter( __in HANDLE hPrinter, __in DWORD Level, __in LPBYTE pDocInfo ); |
PowerBASIC 语法
FUNCTION StartDoc ( _ BYVAL hdc AS DWORD, _ BYVAL Level AS DWORD, _ BYREF pDocInfo AS ANY _ ) AS LONG |
参数
hdc
[in]处理打印作业的设备上下文。
Level
[in]指定pDocInfo指向的结构的版本。
Windows NT / 2000 / XP / Vista / Windows 7：此值必须为1。
Windows 95/98 / Me：该值可以是1或2。
pDocInfo
[in]指向要描述要打印的文档的结构的指针。
Windows NT / 2000 / XP / Vista / Windows 7：pDocInfo是一个指向DOC_INFO_1结构的指针。
Windows 95/98 / Me：pDocInfo是一个指向DOC_INFO_1或DOC_INFO_2结构的指针。
返回值
如果函数成功，则返回值标识打印作业。
如果函数失败，返回值为零。
备注
返回值永远不会大于2 ^ 32 1。
Windows 95/98 / Me：Microsoft Layer for Unicode支持StartDocPrinterW.
打印作业的顺序如下：
| 1. | 要开始打印作业，请调用StartDocPrinter. |
| 2. | 要开始每个页面，请调用StartPagePrinter. |
| 3. | 要将数据写入页面，请调用WritePrinter. |
| 4. | 要结束每一页，请调用EndPagePrinter. |
| 5. | 根据需要重复2次，3次和4次多页。 |
| 6. | 要结束打印作业，请调用EndDocPrinter. |
Windows 2000 / XP / Vista / Windows 7：假脱机文件中的页面超过350 MB时，可能无法打印而不发送错误消息。例如，打印大型EMF文件时可能会发生这种情况。页面大小限制取决于许多因素，包括可用的虚拟内存量，调用进程分配的内存量以及进程堆中的碎片数量。
引用文件 #INCLUDE Once
WinSpool.inc