PrtFilterJobData

La fonction PrtFilterJobData est appelée pour permettre à la DLL utilisateur de manipuler les données de l’imprimante avant leur impression. Cela permet à la DLL de fournir un traitement personnalisé pour les données d’impression envoyées au serveur d’impression.

Syntaxe

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

Paramètres

Uniqueid
Paramètre fourni. Valeur UniqueID retournée par la fonction PrtFilterJobStart pour identifier un travail d’impression.

pBufPtr
Le serveur d’impression transmet les données d’impression reçues de l’hôte à la DLL utilisateur pour traitement dans cette mémoire tampon entrante. La DLL utilisateur retourne au serveur d’impression un pointeur vers une mémoire tampon sortante de données à imprimer. Ce pointeur de mémoire tampon sortant peut être différent du pointeur de mémoire tampon reçu, car la DLL du filtre de données d’impression peut modifier les données. Notez que dans ce cas , PrtFilterFree est appelé uniquement par le service d’impression hôte pour le pointeur de mémoire tampon sortant. Si nécessaire, la DLL de filtre de données d’impression doit appeler sa propre fonction libre sur le pointeur de mémoire tampon entrant qui a été fourni à la fonction PrtFilterJobData . Cette mémoire tampon entrante a été allouée par un service d’impression hôte par un appel précédent à PrtFilterAlloc.

pBufLen
Indique la longueur des données passées dans la mémoire tampon au serveur d’impression et la longueur de la mémoire tampon retournée au serveur d’impression par la DLL fournie par l’utilisateur.

Remarques

Les données de la mémoire tampon sont des séquences de contrôle d’imprimante et/ou ASCII imprimables si elles sont envoyées dans les travaux d’impression. La mémoire tampon retournée par la DLL utilisateur ne doit pas être identique à la mémoire tampon passée. La mémoire tampon retournée est toujours libérée en appelant PrtFilterFree une fois que les données ont été mises en pool. Le paramètre d’identificateur unique UniqueID est l’identificateur retourné par un appel précédent à la fonction PrtFilterJobStart .

Voir aussi

PrtFilterFree
PrtFilterJobStart