Função PrintDocumentOnPrintProcessor (winsplp.h)
A função PrintDocumentOnPrintProcessor de um processador de impressão converte um trabalho de impressão de um formato de spool em dados brutos que podem ser enviados para um monitor de impressão.
Sintaxe
BOOL PrintDocumentOnPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] LPWSTR pDocumentName
);
Parâmetros
[in] hPrintProcessor
Identificador do processador de impressão fornecido pelo chamador. Esse é o identificador retornado por uma chamada anterior para OpenPrintProcessor .
[in] pDocumentName
Ponteiro fornecido pelo chamador para o nome do documento.
Valor de retorno
Se a operação for bem-sucedida, a função deverá retornar VERDADEIRO. Se a operação falhar, a função deverá chamar SetLastError para definir um código de erro e retornar FALSE.
Observações
Os processadores de impressão são necessários para exportar uma função PrintDocumentOnPrintProcessor. O spooler chama a função depois de chamar OpenPrintProcessor. A finalidade da função é ler o conteúdo do arquivo nomeado por pDocumentName, converter (se necessário) os dados do arquivo em um fluxo de dados que pode ser lido pelo hardware da impressora e enviar o fluxo de dados de volta para o spooler. Em seguida, o spooler pode enviar o fluxo de dados para o monitor de impressão apropriado.
Se o formato de entrada for EMF do sistema operacional baseado em NT, a função PrintDocumentOnPrintProcessor poderá chamar funções GDI para processadores de impressão. Para obter mais informações, consulte Processando um trabalho de impressão.
O fluxo de dados convertido deve ser enviado de volta ao spooler chamando WritePrinter, que é descrito na documentação do SDK do Microsoft Windows. Para obter mais informações, consulte Processando um trabalho de impressão.
A função PrintDocumentOnPrintProcessor deve ser gravada para manipular solicitações para pausar, retomar ou cancelar o trabalho de impressão. Para obter mais informações, consulte ControlPrintProcessor.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Nwprint.lib |