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)
Library Nwprint.lib

另请参阅

ControlPrintProcessor

OpenPrintProcessor