PrtFilterJobStart

La fonction PrtFilterJobStart est appelée pour informer la DLL de filtre de données d’impression qu’un nouveau travail vient d’être démarré. Cela permet à la DLL de fournir un traitement personnalisé et d’envoyer des données spéciales au serveur d’impression au début d’un travail.

Syntaxe

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

Paramètres

SessionName
Paramètre fourni. Nom de la session d’impression qui vient de démarrer un travail d’impression. SessionName est identique à celui configuré dans à l’aide de l’outil de Administration service d’impression SNA.

LUType
Paramètre fourni. Spécifie le type d’imprimante. Les valeurs valides sont les imprimantes LU 1, LU 3 ou LU 6.2, représentées par une valeur LUType de 1, 3 ou 6.

pBufPtr
Paramètre retourné. Spécifie un pointeur vers un pointeur de mémoire tampon contenant des données supplémentaires à imprimer par le serveur d’impression.

pBufLen
Paramètre retourné. Pointeur vers la longueur des données fournies par la DLL de filtre de données d’impression dans la mémoire tampon.

Valeur renvoyée

La fonction PrtFilterJobStart renvoie un identificateur unique (converti en pointeur vers un void) si elle souhaite avoir la possibilité de filtrer les données de ce travail d’impression.

Si la DLL utilisateur retourne un pointeur NULL, cela indique qu’il n’est pas intéressé par le filtrage de ce travail. Aucun autre appel à la DLL utilisateur ne sera effectué pour ce travail d’impression.

Remarques

Aucune donnée n’est passée dans la mémoire tampon de données à la DLL de filtre de données d’impression dans cet appel, mais la DLL peut retourner des données dans pBufPtr (par exemple, une page de bannière). Les données retournées par cet appel doivent être des séquences de contrôle d’imprimante et/ou ASCII imprimables.