Share via

Fonction GdiGetSpoolFileHandle (winppi.h)

  • Article

La fonction GdiGetSpoolFileHandle retourne un handle au fichier EMF d’un travail d’impression.

Syntaxe

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

Paramètres

pwszPrinterName

Pointeur fourni par l’appelant vers une chaîne représentant le nom de l’imprimante cible. Consultez la section Remarques suivante.

pDevmode

Pointeur fourni par l’appelant vers une structure DEVMODEW . Consultez la section Remarques suivante.

pwszDocName

Pointeur fourni par l’appelant vers le nom du document du travail d’impression. Consultez la section Remarques suivante.

Valeur retournée

Si l’opération réussit, la fonction retourne un handle de fichier de pool. Sinon, la fonction retourne NULL.

Remarques

La fonction GdiGetSpoolFileHandle est exportée par gdi32.dll pour une utilisation dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.

Lorsqu’un processeur d’impression appelle GdiGetSpoolFileHandle, il doit fournir des arguments comme illustré dans le tableau suivant.

Paramètre Argument
pwszPrinterName Pointeur vers le nom de l’imprimante reçu par la fonction OpenPrintProcessor du processeur d’impression.
pDevmode Pointeur vers la structure DEVMODEW contenue dans la structure PRINTPROCESSOROPENDATA , reçue par la fonction OpenPrintProcessor du processeur d’impression.
pwszDocName Pointeur de nom de document reçu par la fonction PrintDocumentOnPrintProcessor du processeur d’impression.

Un processeur d’impression doit appeler la fonction GdiGetSpoolFileHandle avant d’appeler d’autres fonctions d’impression GDI, car le handle retourné doit être passé aux autres fonctions. La fonction appelle OpenPrinter pour ouvrir une connexion à l’imprimante et CreateDC pour créer un contexte d’appareil pour le dessin. Le processeur d’impression peut obtenir le handle du contexte de l’appareil en appelant GdiGetDC.

Pour plus d’informations, consultez Utilisation de fonctions GDI dans les processeurs d’impression.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête winppi.h (inclure Winppi.h)
Bibliothèque Gdi32.Lib
DLL Gdi32.dll

Voir aussi

GdiDeleteSpoolFileHandle