OpenPrintProcessor, fonction (winsplp.h)

Article
02/07/2025

La fonction OpenPrintProcessor d’un processeur d’impression prépare le processeur d’impression pour l’impression d’un travail et retourne un handle.

Syntaxe

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Paramètres

[in] pPrinterName

Pointeur fourni par l’appelant vers le nom de l’imprimante pour laquelle le processeur d’impression est ouvert.

[in] pPrintProcessorOpenData

Pointeur fourni par l’appelant vers une structure PRINTPROCESSOROPENDATA.

Valeur de retour

Si l’opération réussit, la fonction doit retourner un handle qui peut être utilisé comme argument d’entrée pour les appels suivants à PrintDocumentOnPrintProcessor, ControlPrintProcessoret ClosePrintProcessor. Si l’opération échoue, la fonction doit appeler SetLastError pour définir un code d’erreur, puis retourner NULL.

Remarques

Les processeurs d’impression sont nécessaires pour exporter une fonction OpenPrintProcessor. Le spouleur appelle la fonction lorsqu’un travail d’impression est disponible. La fonction doit effectuer des opérations d’initialisation requises avant qu’un travail puisse être traité, en fonction du type de données du travail.

La fonction doit retourner un handle. En règle générale, le handle est un pointeur vers une structure interne. La structure doit contenir un pointeur vers le nom de l’imprimante et un pointeur vers la structure DEVMODEW de l’imprimante, qui sont toutes deux reçues dans la structure PRINTPROCESSOROPENDATA. Ces deux pointeurs sont requis par la fonction PrintDocumentOnPrintProcessor du processeur d’impression, et cette dernière fonction reçoit le handle comme entrée lorsque le spouleur l’appelle.