Função PrintDocumentOnPrintProcessor (winsplp.h)

  • Artigo

A função de um processador de PrintDocumentOnPrintProcessor 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.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE. Se a operação falhar, a função deverá chamar SetLastError para definir um código de erro e retornar FALSE.

Comentários

Processadores de impressão são necessários para exportar uma PrintDocumentOnPrintProcessor função. O spooler chama a função depois de chamar OpenPrintProcessor. A finalidade da função é ler o conteúdo do arquivo chamado por pDocumentName, converter (se necessário) os dados do arquivo em um fluxo de dados que possa 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 PrintDocumentOnPrintProcessor função 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 PrintDocumentOnPrintProcessor função 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
Plataforma de Destino Área de Trabalho
Cabeçalho winsplp.h (inclua Winsplp.h)
Biblioteca Nwprint.lib

Confira também

ControlPrintProcessor

OpenPrintProcessor