Funzione OpenPrintProcessor (winsplp.h)

Articolo
08/08/2023

La funzione del OpenPrintProcessor processore di stampa prepara il processore di stampa per la stampa di un processo e restituisce un handle.

Sintassi

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Parametri

[in] pPrinterName

Puntatore fornito dal chiamante al nome della stampante per cui viene aperto il processore di stampa.

[in] pPrintProcessorOpenData

Puntatore fornito dal chiamante a una struttura PRINTPROCESSOROPENDATA .

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire un handle che può essere usato come argomento di input per le chiamate successive a PrintDocumentOnPrintProcessor, ControlPrintProcessor e ClosePrintProcessor. Se l'operazione ha esito negativo, la funzione deve chiamare SetLastError per impostare un codice di errore e quindi restituire NULL.

Commenti

I processori di stampa sono necessari per esportare una OpenPrintProcessor funzione. Il spooler chiama la funzione quando è disponibile un processo di stampa. La funzione deve eseguire operazioni di inizializzazione necessarie prima che un processo possa essere elaborato, in base al tipo di dati del processo.

La funzione deve restituire un handle. In genere, l'handle è un puntatore a una struttura interna. La struttura deve contenere un puntatore al nome della stampante e un puntatore alla struttura DEVMODEW della stampante, entrambi ricevuti nella struttura PRINTPROCESSOROPENDATA . Questi due puntatori sono richiesti dalla funzione PrintDocumentOnPrintProcessor del processore di stampa e questa seconda funzione riceve l'handle come input quando lo spooler lo chiama.