Funzione PrintDocumentOnPrintProcessor (winsplp.h)

La funzione di un processore di PrintDocumentOnPrintProcessor stampa converte un processo di stampa da un formato spooling in dati non elaborati che possono essere inviati a un monitor di stampa.

Sintassi

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

Parametri

[in] hPrintProcessor

Handle del processore di stampa fornito dal chiamante. Si tratta dell'handle restituito da una chiamata precedente a OpenPrintProcessor.

[in] pDocumentName

Puntatore fornito dal chiamante al nome del documento.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. Se l'operazione non riesce, la funzione deve chiamare SetLastError per impostare un codice di errore e quindi restituire FALSE.

Commenti

I processori di stampa sono necessari per esportare una PrintDocumentOnPrintProcessor funzione. Lo spooler chiama la funzione dopo aver chiamato OpenPrintProcessor. Lo scopo della funzione è leggere il contenuto del file denominato da pDocumentName, convertire (se necessario) i dati del file in un flusso di dati che può essere letto dall'hardware della stampante e inviare nuovamente il flusso di dati allo spooler. Lo spooler può quindi inviare il flusso di dati al monitor di stampa appropriato.

Se il formato di input è basato su NT EMF, la PrintDocumentOnPrintProcessor funzione può chiamare funzioni GDI per processori di stampa. Per altre informazioni, vedere Elaborazione di un processo di stampa.

Il flusso di dati convertito deve essere inviato di nuovo allo spooler chiamando WritePrinter, descritto nella documentazione di Microsoft Windows SDK. Per altre informazioni, vedere Elaborazione di un processo di stampa.

La PrintDocumentOnPrintProcessor funzione deve essere scritta per gestire le richieste di sospensione, ripresa o annullamento del processo di stampa. Per altre informazioni, vedere ControlPrintProcessor.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winsplp.h (include Winsplp.h)
Libreria	Nwprint.lib

Vedi anche

ControlPrintProcessor

OpenPrintProcessor