Fonction DrvSendPage (winddi.h)
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.
Configuration requise
| Plateforme cible | Bureau |
| En-tête | winddi.h (inclure Winddi.h) |