PrtFilterJobStart

La funzione PrtFilterJobStart viene chiamata per informare la DLL del filtro dati di stampa che è stato appena avviato un nuovo processo. Ciò consente alla DLL di fornire l'elaborazione personalizzata e inviare dati speciali al server di stampa all'inizio di un processo.

Sintassi

  
          void * WINAPI PrtFilterJobStart(   
char *SessionName,    
DWORD LUType,         
char **pBufPtr,       
DWORD *pBufLen      );  

Parametri

SessionName
Parametro fornito. Nome della sessione di stampa che ha appena avviato un processo di stampa. SessionName è uguale a quello configurato con lo strumento di amministrazione del servizio di stampa SNA.

LUType
Parametro fornito. Specifica il tipo di stampante. I valori validi sono le stampanti LU 1, LU 3 o LU 6.2, rappresentate da un valore LUType pari a 1, 3 o 6.

pBufPtr
Parametro restituito. Specifica un puntatore a un buffer di puntatori che contiene dati aggiuntivi da elaborare per la stampa dal server di stampa.

pBufLen
Parametro restituito. Puntatore che indica la lunghezza dei dati forniti dalla DLL del filtro dati di stampa nel buffer.

Valore restituito

La funzione PrtFilterJobStart restituisce un identificatore univoco (convertito in un puntatore a void) se desidera avere l'opportunità di filtrare i dati per questo processo di stampa.

Se la DLL utente restituisce un puntatore NULL, indica che non è interessato a filtrare questo processo. Non verranno effettuate ulteriori chiamate alla DLL utente per questo processo di stampa.

Osservazioni:

Nessun dato viene passato nel buffer di dati alla DLL del filtro dati di stampa in questa chiamata, ma la DLL può restituire dati in pBufPtr (ad esempio, una pagina banner). I dati restituiti da questa chiamata dovrebbero essere codici ASCII stampabili e/o sequenze di controllo per stampanti.