Funzione DrvSendPage (winddi.h)

Articolo
08/27/2023

La funzione DrvSendPage di una DLL della grafica della stampante viene chiamata da GDI al termine del disegno di una pagina fisica, in modo che il driver possa inviare la pagina alla stampante.

Sintassi

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Parametri

[in] pso

Puntatore fornito dal chiamante a una struttura SURFOBJ che descrive la superficie di disegno.

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

GDI chiama DrvSendPage ogni volta che ha completato il disegno dell'immagine di una pagina fisica sull'area di disegno. La funzione è responsabile della chiamata di EngWritePrinter per inviare l'immagine alla stampante e per l'esecuzione di operazioni di fine pagina, ad esempio l'espulsione della pagina.

Le DLL grafiche della stampante che usano superfici gestite da GDI vengono in genere implementate in modo che per le pagine raggruppate, l'immagine per ogni banda venga inviata alla stampante dalla funzione DrvNextBand del driver.

Inoltre, se una DLL grafica della stampante usa una superficie gestita dal dispositivo, la funzione DrvSendPage in genere deve eseguire solo operazioni di fine pagina, perché l'immagine viene inviata alla stampante mentre viene disegnata.

Se l'esecuzione di questa funzione richiede molto tempo, deve chiamare EngCheckAbort ogni cinque secondi. Se EngCheckAbort restituisceTRUE, DrvSendPage deve terminare l'operazione e restituire FALSE.