Fonction OpenPrintProcessor (winsplp.h)

Article
02/27/2024

La fonction d’un OpenPrintProcessor 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 retournée

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, ControlPrintProcessor et 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 OpenPrintProcessor fonction. Le spouleur appelle la fonction lorsqu’un travail d’impression est disponible. La fonction doit effectuer des opérations d’initialisation qui sont 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 tous deux reçus 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 en tant qu’entrée lorsque le spouleur l’appelle.