Funzione DrvQueryPerBandInfo (winddi.h)

La funzione DrvQueryPerBandInfo di una DLL della grafica della stampante viene chiamata da GDI prima di iniziare a disegnare una banda per una pagina fisica, in modo che il driver possa fornire informazioni specifiche della banda.

Sintassi

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

Parametri

[in] pso

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

[in, out] pbi

Puntatore fornito dal chiamante a una struttura PERBANDINFO contenente informazioni predefinite, che la funzione può sovrascrivere.

Valore restituito

La funzione deve restituire uno dei valori seguenti:

Codice restituito	Descrizione
Maggiore di zero	GDI userà il contenuto della struttura PERBANDINFO.
Zero	GDI ignorerà il contenuto della struttura PERBANDINFO.
DDI_ERROR	GDI non disegnerà la banda.

Commenti

Se una DLL grafica della stampante usa superfici gestite da GDI e, se supporta la banda superficiale, può facoltativamente fornire una funzione DrvQueryPerBandInfo . GDI chiama la funzione prima del rendering di ogni banda.

La DLL grafica della stampante usa la struttura PERBANDINFO della funzione per indicare se la banda precedente deve essere ridisegnata e per specificare che la banda deve essere ridimensionata. Se una DLL grafica della stampante supporta il banding ma non fornisce una funzione DrvQueryPerBandInfo , GDI non ripete o ridimensiona le bande.

La funzione DrvQueryPerBandInfo viene chiamata solo durante la riproduzione di file EMF.

Requisiti

Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche

DrvNextBand

DrvStartBanding