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:
| Rückgabecode | Beschreibung |
|---|---|
|
GDI verwendet den Inhalt der PERBANDINFO-Struktur. |
|
GDI ignoriert den Inhalt der PERBANDINFO-Struktur. |
|
GDI wird das Band nicht zeichnen. |
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
| Zielplattform | Desktop |
| Kopfzeile | winddi.h (einschließlich Winddi.h) |