PrtFilterJobStart

Se llama a la función PrtFilterJobStart para informar al archivo DLL del filtro de datos de impresión que se acaba de iniciar un nuevo trabajo. Esto permite que el archivo DLL proporcione procesamiento personalizado y envíe datos especiales al servidor de impresión al principio de un trabajo.

Sintaxis

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

Parámetros

SessionName
Parámetro proporcionado. Nombre de la sesión de impresión que acaba de iniciar un trabajo de impresión. SessionName es el mismo que el configurado en mediante la herramienta SNA Print Service Administración.

LUType
Parámetro proporcionado. Especifica el tipo de impresora. Los valores válidos son impresoras LU 1, LU 3 o LU 6.2, representadas por un valor LUType de 1, 3 o 6.

pBufPtr
Parámetro devuelto. Especifica un puntero a un puntero de búfer que contiene datos adicionales que el servidor de impresión imprimirá.

pBufLen
Parámetro devuelto. Puntero a la longitud de los datos proporcionados por el archivo DLL del filtro de datos de impresión en el búfer.

Valor devuelto

La función PrtFilterJobStart devuelve un identificador único (convertido a un puntero a un void) si quiere la oportunidad de filtrar los datos de este trabajo de impresión.

Si el archivo DLL de usuario devuelve un puntero NULL, indica que no está interesado en filtrar este trabajo. No se realizarán más llamadas al archivo DLL de usuario para este trabajo de impresión.

Comentarios

No se pasa ningún dato en el búfer de datos al archivo DLL de filtro de datos de impresión en esta llamada, pero el archivo DLL puede devolver datos en pBufPtr (por ejemplo, una página de banner). Los datos devueltos desde esta llamada deben ser secuencias de control ASCII o de impresora imprimibles.