PrtFilterJobData
La funzione PrtFilterJobData viene chiamata per concedere all'utente DLL l'opportunità di modificare i dati della stampante prima che vengano stampati. Ciò consente alla DLL di fornire l'elaborazione personalizzata per i dati di stampa inviati al server di stampa.
Sintassi
void WINAPI PrtFilterJobData(
void *UniqueID,
char **pBufPtr,
DWORD *pBufLen );
Parametri
Uniqueid
Parametro fornito. Valore UniqueID restituito dalla funzione PrtFilterJobStart per identificare un processo di stampa.
pBufPtr
Il server di stampa passa i dati di stampa ricevuti dall'host alla DLL utente per l'elaborazione nel buffer in ingresso. La DLL utente torna al server di stampa un puntatore a un buffer di dati in uscita da stampare. Questo puntatore al buffer in uscita può essere diverso dal puntatore del buffer ricevuto perché la DLL del filtro dati di stampa può modificare i dati. Si noti che in questo caso PrtFilterFree verrà chiamato solo dal servizio di stampa host per il puntatore del buffer in uscita. Se necessario, la DLL del filtro dati di stampa deve chiamare la propria funzione libera sul puntatore del buffer in ingresso fornito alla funzione PrtFilterJobData . Questo buffer in ingresso è stato allocato da un servizio di stampa host da una chiamata precedente a PrtFilterAlloc.
pBufLen
Indica la lunghezza dei dati passati nel buffer al server di stampa e la lunghezza del buffer restituito al server di stampa dalla DLL fornita dall'utente.
Commenti
I dati nel buffer sono sequenze di controllo ASCII e/o stampanti stampabili se vengono inviati nei processi di stampa. Il buffer restituito dalla DLL utente non deve essere uguale al buffer passato. Il buffer restituito verrà sempre liberato chiamando PrtFilterFree dopo lo spooling dei dati. Il parametro unique identifier UniqueID è l'identificatore restituito da una chiamata precedente alla funzione PrtFilterJobStart .