PrtFilterJobStart 函式被呼叫用來通知列印資料過濾器 DLL 剛剛開始一個新工作。 這使得 DLL 能提供自訂處理,並在工作開始時向列印伺服器傳送特殊資料。
語法
void * WINAPI PrtFilterJobStart(
char *SessionName,
DWORD LUType,
char **pBufPtr,
DWORD *pBufLen );
參數
SessionName
提供的參數。 剛剛開始列印工作的列印會話名稱。
SessionName 與使用 SNA 列印服務管理工具時設定的相同。
LUType
提供的參數。 指定印表機類型。 有效的值為 LU 1、LU 3 或 LU 6.2 印表機,分別以 LUType 值 1、3 或 6 表示。
pBufPtr
回傳參數。 指定一個指向緩衝區指標的指標,該指標儲存有列印伺服器需列印的額外資料。
pBufLen
回傳參數。 指標指向由列印資料過濾器 DLL 在緩衝區中提供的資料長度。
傳回值
PrtFilterJobStart 函式若想要過濾此列印工作的資料,會回傳一個唯一識別碼(轉換為 void 指標)。
如果使用者 DLL 回傳 NULL 指標,表示不打算過濾此工作。 不會再呼叫使用者 DLL 來處理此列印工作。
備註
在此呼叫中,資料不會傳送到列印資料過濾器 DLL 的資料緩衝區,但 DLL 可以在 pBufPtr 回傳資料(例如橫幅頁面)。 此呼叫回傳的資料應為可列印的 ASCII 及/或印表機控制序列。