Функция PrintDocumentOnPrintProcessor (winsplp.h)
Функция PrintDocumentOnPrintProcessor обработчика печати преобразует задание печати из spooled format в необработанные данные, которые можно отправить в монитор печати.
Синтаксис
BOOL PrintDocumentOnPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] LPWSTR pDocumentName
);
Параметры
[in] hPrintProcessor
Дескриптор печати, предоставленный вызывающим обработчиком. Это дескриптор, возвращаемый предыдущим вызовом OpenPrintProcessor.
[in] pDocumentName
Вызывающий указатель на имя документа.
Возвращаемое значение
Если операция выполнена успешно, функция должна вернуть TRUE. Если операция завершается ошибкой, функция должна вызывать SetLastError, чтобы задать код ошибки, а затем вернуть FALSE.
Замечания
Процессоры печати необходимы для экспорта функции PrintDocumentOnPrintProcessor. Spooler вызывает функцию после вызова OpenPrintProcessor. Цель функции — считывать содержимое файла с именем pDocumentName, преобразовывать (при необходимости) данные файла в поток данных, который можно считывать оборудованием принтера, и отправлять поток данных обратно в spooler. Затем spooler может отправить поток данных в соответствующий монитор печати.
Если входной формат — EMF операционной системы на основе NT, функция PrintDocumentOnPrintProcessor может вызывать функции GDI для процессоров печати. Дополнительные сведения см. в разделе Обработка задания печати.
Преобразованный поток данных должен быть отправлен обратно в spooler путем вызова WritePrinter, который описан в документации по пакету SDK для Microsoft Windows. Дополнительные сведения см. в разделе Обработка задания печати.
Функция PrintDocumentOnPrintProcessor должна быть записана для обработки запросов на приостановку, возобновление или отмену задания печати. Дополнительные сведения см. в ControlPrintProcessor.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | winsplp.h (include Winsplp.h) |
| библиотеки | Nwprint.lib |