DrvQueryPerBandInfo-Funktion (winddi.h)

Die DrvQueryPerBandInfo-Funktion einer Druckergrafik-DLL wird von GDI aufgerufen, bevor mit dem Zeichnen eines Bandes für eine physische Seite begonnen wird, sodass der Treiber GDI bandspezifische Informationen bereitstellen kann.

Syntax

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

Parameter

[in] pso

Vom Aufrufer bereitgestellter Zeiger auf eine SURFOBJ-Struktur , die die Zeichnungsoberfläche beschreibt.

[in, out] pbi

Vom Aufrufer bereitgestellter Zeiger auf eine PERBANDINFO-Struktur , die Standardinformationen enthält, die von der Funktion überschrieben werden können.

Rückgabewert

Die Funktion muss einen der folgenden Werte zurückgeben:

Hinweise

Wenn eine Druckergrafik-DLL GDI-verwaltete Oberflächen verwendet und surface-Banding unterstützt, kann optional eine DrvQueryPerBandInfo-Funktion bereitgestellt werden. GDI ruft die Funktion auf, bevor jedes Band gerendert wird.

Die Druckergrafik-DLL verwendet die PERBANDINFO-Struktur der Funktion, um anzugeben, ob das vorherige Band neu gezeichnet werden soll, und um anzugeben, dass das Band skaliert werden soll. Wenn eine Druckergrafik-DLL das Banding unterstützt, aber keine DrvQueryPerBandInfo-Funktion bereitstellt, wiederholt GDI keine Bänder oder skaliert.

Die DrvQueryPerBandInfo-Funktion wird nur während der Wiedergabe von EMF-Dateien aufgerufen.

Anforderungen

Weitere Informationen

DrvNextBand

DrvStartBanding