Fonction DrvSendPage (winddi.h)

Article
08/27/2023

La fonction DrvSendPage d’une DLL de graphique d’imprimante est appelée par GDI lorsqu’elle a fini de dessiner une page physique, de sorte que le pilote peut envoyer la page à l’imprimante.

Syntaxe

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Paramètres

[in] pso

Pointeur fourni par l’appelant vers une structure SURFOBJ qui décrit la surface de dessin.

Valeur retournée

Si l’opération réussit, la fonction doit retourner TRUE. Sinon, elle doit appeler la fonction Win32 SetLastError pour définir un code d’erreur, puis retourner FALSE.

Remarques

GDI appelle DrvSendPage chaque fois qu’il a fini de dessiner l’image d’une page physique sur la surface de dessin. La fonction est chargée d’appeler EngWritePrinter pour envoyer l’image à l’imprimante et d’effectuer des opérations de fin de page, telles que l’éjection de la page.

Les DLL graphiques d’imprimante utilisant des surfaces gérées par GDI sont généralement implémentées de sorte que pour les pages qui sont en bandes, l’image de chaque bande est envoyée à l’imprimante par la fonction DrvNextBand du pilote.

En outre, si une DLL graphique d’imprimante utilise une surface gérée par l’appareil, la fonction DrvSendPage doit généralement effectuer uniquement des opérations de fin de page, car l’image est envoyée à l’imprimante au fur et à mesure qu’elle est dessinée.

Si l’exécution de cette fonction peut prendre beaucoup de temps, elle doit appeler EngCheckAbort toutes les cinq secondes. Si EngCheckAbort retourne TRUE, DrvSendPage doit mettre fin à son opération et retourner FALSE.