Funzione DrvStartBanding (winddi.h)

  • Articolo

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)

Vedi anche

DrvEnableSurface

DrvNextBand

EngMarkBandingSurface