DrvNextBand-Funktion (winddi.h)

Artikel
03/13/2024

Die DrvNextBand-Funktion wird von GDI aufgerufen, wenn das Zeichnen eines Bandes für eine physische Seite abgeschlossen ist, sodass der Treiber das nächste Band an den Drucker senden kann.

Syntax

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

Parameter

[in] pso

Vom Aufrufer bereitgestellter Zeiger auf eine SURFOBJ-Struktur , die die Bandingoberfläche identifiziert.

[in] pptl

Vom Aufrufer bereitgestellter Zeiger auf eine POINTL-Struktur , um den von der Funktion bereitgestellten Ursprung des nächsten Bandes zu empfangen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte die Win32-Funktion SetLastError aufgerufen werden, um einen Fehlercode festzulegen, und dann FALSE zurückgeben.

Hinweise

Wenn eine Druckergrafik-DLL GDI-verwaltete Oberflächen verwendet und surface-Banding unterstützt, muss sie eine DrvNextBand-Funktion bereitstellen. GDI ruft DrvNextBand jedes Mal auf, wenn der Teil des Bilds der Seite, der auf der Bandoberfläche enthalten sein kann, fertig ist. Die von GDI zum Zeichnen verwendete Oberfläche ist eine Oberfläche, die der Treiber zuvor durch Aufrufen von EngMarkBandingSurface angegeben hat. Die Funktion sollte das Bild durch Aufrufen von EngWritePrinter an den Drucker senden und die Indizes des Ursprungs des nächsten Bandes in der POINTL-Struktur zurückgeben, auf die pptl zeigt.

Nachdem alle Bänder einer physischen Seite gezeichnet wurden, sollte die Funktion beide Member der POINTL-Struktur festlegen, auf die pptl zeigt, auf -1.