Funzione DrvNextBand (winddi.h)

Articolo
03/13/2024

La funzione DrvNextBand viene chiamata da GDI al termine del disegno di una banda per una pagina fisica, in modo che il driver possa inviare la banda successiva alla stampante.

Sintassi

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

Parametri

[in] pso

Puntatore fornito dal chiamante a una struttura SURFOBJ , che identifica la superficie di banda.

[in] pptl

Puntatore fornito dal chiamante a una struttura POINTL per ricevere l'origine fornita dalla funzione della banda successiva.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve chiamare la funzione Win32 SetLastError per impostare un codice di errore e quindi restituire FALSE.

Commenti

Se una DLL grafica della stampante usa superfici gestite da GDI e, se supporta la banda della superficie, deve fornire una funzione DrvNextBand . GDI chiama DrvNextBand ogni volta che ha terminato di disegnare la parte dell'immagine della pagina che può essere contenuta sulla superficie della banda. La superficie utilizzata da GDI per il disegno è quella specificata in precedenza dal driver chiamando EngMarkBandingSurface. La funzione deve inviare l'immagine alla stampante chiamando EngWritePrinter e deve restituire gli indici dell'origine della banda successiva nella struttura POINTL a cui punta pptl.

Dopo che tutte le bande di una pagina fisica sono state disegnate, la funzione deve impostare entrambi i membri della struttura POINTL a cui punta pptl su -1.