Функция PrintDocumentOnPrintProcessor (winsplp.h)

Функция обработчика PrintDocumentOnPrintProcessor печати преобразует задание печати из распечатанного формата в необработанные данные, которые можно отправить на монитор печати.

Синтаксис

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

Параметры

[in] hPrintProcessor

Дескриптор обработчика печати, предоставленный вызывающим абонентом. Это дескриптор, возвращенный предыдущим вызовом OpenPrintProcessor.

[in] pDocumentName

Указатель на имя документа, предоставленный вызывающим.

Возвращаемое значение

Если операция выполнена успешно, функция должна вернуть значение TRUE. Если операция завершается сбоем, функция должна вызвать SetLastError , чтобы задать код ошибки, а затем вернуть значение FALSE.

Комментарии

Обработчики печати необходимы для экспорта PrintDocumentOnPrintProcessor функции. Диспетчер очереди очереди вызывает функцию после вызова OpenPrintProcessor. Функция предназначена для чтения содержимого файла с именем pDocumentName, преобразования (при необходимости) данных файла в поток данных, который может быть прочитан оборудованием принтера, и для отправки потока данных обратно в очередь очереди очереди. Затем диспетчер очереди может отправить поток данных на соответствующий монитор печати.

Если входной формат — EMF операционной системы на основе NT, PrintDocumentOnPrintProcessor функция может вызывать функции GDI для процессоров печати. Дополнительные сведения см. в разделе Обработка задания печати.

Преобразованный поток данных должен быть отправлен обратно в очередь очереди, вызвав WritePrinter, как описано в документации по Microsoft Windows SDK. Дополнительные сведения см. в разделе Обработка задания печати.

Функция PrintDocumentOnPrintProcessor должна быть написана для обработки запросов на приостановку, возобновление или отмену задания печати. Дополнительные сведения см. в разделе ControlPrintProcessor.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	winsplp.h (включая Winsplp.h)
Библиотека	Nwprint.lib

См. также раздел

ControlPrintProcessor

OpenPrintProcessor