Функция 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 |