Funzione DrvStartBanding (winddi.h)
La funzione DrvStartBanding viene chiamata da GDI quando è pronta per iniziare a inviare bande di una pagina fisica al driver per il rendering.
Sintassi
BOOL DrvStartBanding(
[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 prima banda.
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 DrvStartBanding solo se la funzione DrvEnableSurface della DLL grafica della stampante precedentemente denominata EngMarkBandingSurface per specificare una superficie di banda.
Lo scopo della funzione DrvStartBanding è consentire alla DLL grafica della stampante di eseguire le inizializzazioni necessarie prima dell'inizio delle operazioni di banding in una pagina fisica e fornire all'GDI gli indici dell'origine della prima band.
La funzione DrvStartBanding viene chiamata una volta per pagina. Ogni volta che GDI ha completato il disegno di una banda, chiama DrvNextBand in modo che il driver possa inviare la banda alla stampante.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | winddi.h (include Winddi.h) |