GdiStartDocEMF, fonction (winppi.h)

La fonction GdiStartDocEMF effectue des opérations d’initialisation pour un travail d’impression au format EMF.

Syntaxe

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Paramètres

SpoolFileHandle

Handle de fichier de pool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.

pDocInfo

Pointeur fourni par l’appelant vers une structure DOCINFOW (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Window).

Valeur retournée

Si l’opération réussit, la fonction retourne TRUE. Sinon, la fonction retourne FALSE et un code d’erreur peut être obtenu en appelant GetLastError.

Remarques

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

La fonction effectue des initialisations qui doivent avoir lieu avant que les enregistrements EMF d’un travail d’impression puissent être lus. La fonction appelle la fonction StartDoc du spouleur (décrite dans la documentation du Kit de développement logiciel (SDK) Windows, qui à son tour appelle la fonction DrvStartDoc du pilote d’imprimante.

Le processeur d’impression doit définir le membre lpszOutput de la structure DOCINFOW sur le nom de fichier de sortie contenu dans la structure PRINTPROCESSOROPENDATA , précédemment reçue par la fonction OpenPrintProcessor .

Le processeur d’impression doit définir le membre lpszDocName de la structure DOCINFOW sur le pointeur de nom de document, précédemment reçu par la fonction PrintDocumentOnPrintProcessor .

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

Configuration requise

Voir aussi

GdiEndDocEMF