PrtFilterJobStart

Se llama a la función PrtFilterJobStart para informar al archivo DLL del filtro de datos de impresión que acaba de iniciarse 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 usando la herramienta de administración del servicio de impresión de SNA.

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 buffer que contiene datos adicionales que el servidor de impresión debe imprimir.

pBufLen
Parámetro devuelto. Puntero a la longitud de los datos proporcionados por la 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 void) si desea 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.

Observaciones

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