Fonction DrvNextBand (winddi.h)

Article
03/04/2024

La fonction DrvNextBand est appelée par GDI lorsqu’elle a fini de dessiner une bande pour une page physique, de sorte que le pilote peut envoyer la bande suivante à l’imprimante.

Syntaxe

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

Paramètres

[in] pso

Pointeur fourni par l’appelant vers une structure SURFOBJ , qui identifie la surface de bande.

[in] pptl

Pointeur fourni par l’appelant vers une structure POINTL pour recevoir l’origine fournie par la fonction de la bande suivante.

Valeur retournée

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

Remarques

Si une DLL graphique d’imprimante utilise des surfaces gérées par GDI et qu’elle prend en charge la bande de surface, elle doit fournir une fonction DrvNextBand . GDI appelle DrvNextBand chaque fois qu’il a fini de dessiner la partie de l’image de la page qui peut être contenue sur la surface de la bande. La surface utilisée par GDI pour le dessin est celle que le pilote a précédemment spécifiée en appelant EngMarkBandingSurface. La fonction doit envoyer l’image à l’imprimante en appelant EngWritePrinter, et elle doit retourner les index de l’origine de la bande suivante dans la structure POINTL pointée vers pptl.

Une fois toutes les bandes d’une page physique dessinées, la fonction doit définir les deux membres de la structure POINTL pointés par pptl sur -1.