PrtFilterJobData

呼叫 PrtFilterJobData 函式,讓使用者 DLL 有機會在列印之前操作印表機資料。 這可讓 DLL 為傳送至列印伺服器的列印資料提供自訂處理。

語法

  
          void WINAPI PrtFilterJobData(   
void *UniqueID,   
char **pBufPtr,   
DWORD *pBufLen  );  

參數

唯一
提供的參數。 PrtFilterJobStart函數傳回的UniqueID值,用來識別列印工作。

pBufPtr
列印伺服器會將接收自主控制項的列印資料傳遞給使用者 DLL,以便在這個傳入的緩衝區中進行處理。 使用者 DLL 會將要列印之資料的傳出緩衝區指標傳回給列印伺服器。 此傳出緩衝區指標可能與接收的緩衝區指標不同,因為列印資料篩選 DLL 可以修改資料。 請注意,在此情況下, PrtFilterFree 只會由主控制項列印服務針對傳出緩衝區指標呼叫。 如有必要,print data filter DLL 必須在提供給 PrtFilterJobData 函式的傳入緩衝區指標上,呼叫它自己的 free 函數。 這個傳入的緩衝區是由先前呼叫 PrtFilterAlloc 的主機列印服務所配置

pBufLen
表示緩衝區中傳遞給列印伺服器的資料長度,以及由使用者提供之 DLL 傳回給列印伺服器的緩衝區長度。

備註

緩衝區中的資料是可列印的 ASCII 和/或印表機控制序列(如果這些資料是在列印工作中傳送)。 使用者 DLL 所傳回的緩衝區不必與傳入的緩衝區相同。 在資料已進行多工緩衝處理之後,會呼叫 PrtFilterFree ,以釋放傳回的緩衝區。 唯一識別碼參數 UniqueID 是從先前呼叫 PrtFilterJobStart 函數所傳回的識別碼。

另請參閱

PrtFilterFree
PrtFilterJobStart