PrintDocumentOnPrintProcessor 函数 (winsplp.h)

打印处理器的 PrintDocumentOnPrintProcessor 函数将打印作业从后台打印格式转换为可以发送到打印监视器的原始数据。

语法

BOOL PrintDocumentOnPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] LPWSTR pDocumentName
);

参数

[in] hPrintProcessor

调用方提供的打印处理器句柄。 这是上一次调用 OpenPrintProcessor返回的句柄。

[in] pDocumentName

调用方提供的指向文档名称的指针。

返回值

如果作成功,函数应返回 true 。 如果作失败,该函数应调用 SetLastError 来设置错误代码,然后返回 FALSE

言论

导出 PrintDocumentOnPrintProcessor 函数需要打印处理器。 后台处理程序在调用 OpenPrintProcessor后调用函数。 函数的目的是读取由 pDocumentName命名的文件的内容,将文件的数据转换为可由打印机硬件读取的数据流,并将数据流发送回后台处理程序。 然后,后台处理程序可以将数据流发送到相应的 打印监视器

如果输入格式是基于 NT 的作系统 EMF,PrintDocumentOnPrintProcessor 函数可以针对打印处理器 调用GDI 函数。 有关详细信息,请参阅 处理打印作业

转换后的数据流必须通过调用 WritePrinter(Microsoft Windows SDK 文档中所述)发送回后台处理程序。 有关详细信息,请参阅 处理打印作业

必须写入 PrintDocumentOnPrintProcessor 函数来处理暂停、恢复或取消打印作业的请求。 有关详细信息,请参阅 ControlPrintProcessor

要求

要求 价值
目标平台 桌面
标头 winsplp.h (包括 Winsplp.h)
Nwprint.lib

另请参阅

ControlPrintProcessor

OpenPrintProcessor