Fonction DrvStartBanding (winddi.h)

La fonction DrvStartBanding est appelée par GDI lorsqu’elle est prête à commencer à envoyer des bandes d’une page physique au pilote pour le rendu.

Syntaxe

BOOL DrvStartBanding(
  [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 première bande.

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

Si une DLL de graphisme d’imprimante utilise des surfaces gérées par GDI et si elle prend en charge le bandeau de surface, elle doit fournir une fonction DrvNextBand . GDI appelle DrvStartBanding uniquement si la fonction DrvEnableSurface de la DLL graphique de l’imprimante s’appelait précédemment EngMarkBandingSurface pour spécifier une surface de bande.

L’objectif de la fonction DrvStartBanding est de permettre à la DLL des graphiques d’imprimante d’effectuer toutes les initialisations nécessaires avant que les opérations de bande ne commencent sur une page physique, et de fournir à GDI les index de l’origine de la première bande.

La fonction DrvStartBanding est appelée une fois par page. Chaque fois que GDI a fini de dessiner une bande, il appelle DrvNextBand afin que le pilote puisse envoyer la bande à l’imprimante.

Configuration requise

Voir aussi

DrvEnableSurface

DrvNextBand

EngMarkBandingSurface