PrtFilterJobData

Se llama a la función PrtFilterJobData para ofrecer al archivo DLL del usuario la oportunidad de manipular los datos de la impresora antes de imprimirlos. Esto permite que el archivo DLL proporcione procesamiento personalizado para los datos de impresión enviados al servidor de impresión.

Sintaxis

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

Parámetros

Uniqueid
Parámetro proporcionado. Valor UniqueID devuelto por la función PrtFilterJobStart para identificar un trabajo de impresión.

pBufPtr
El servidor de impresión pasa los datos de impresión recibidos del host al archivo DLL de usuario para su procesamiento en este búfer de entrada. El archivo DLL de usuario devuelve al servidor de impresión un puntero a un búfer de salida de datos que se va a imprimir. Este puntero de búfer saliente puede ser diferente del puntero de búfer recibido porque el archivo DLL de filtro de datos de impresión puede modificar los datos. Tenga en cuenta que en este caso PrtFilterFree solo será llamado por el servicio de impresión de host para el puntero de búfer saliente. Si es necesario, el archivo DLL de filtro de datos de impresión debe llamar a su propia función free en el puntero de búfer entrante que se proporcionó a la función PrtFilterJobData . Un servicio de impresión de host asignó este búfer entrante mediante una llamada anterior a PrtFilterAlloc.

pBufLen
Indica la longitud de los datos pasados en el búfer al servidor de impresión y la longitud del búfer devuelto al servidor de impresión por el archivo DLL proporcionado por el usuario.

Observaciones

Los datos del búfer son secuencias de control ASCII o impresora imprimibles si se envían en los trabajos de impresión. El búfer devuelto por el archivo DLL de usuario no tiene que ser el mismo que el búfer pasado. El búfer devuelto siempre se liberará mediante una llamada a PrtFilterFree después de que los datos se hayan puesto en cola. El parámetro unique identifier UniqueID es el identificador devuelto por una llamada anterior a la función PrtFilterJobStart .

Consulte también

PrtFilterFree
PrtFilterJobStart