DrvStartBanding-Funktion (winddi.h)

Artikel
03/04/2024

Die DrvStartBanding-Funktion wird von GDI aufgerufen, wenn sie bereit ist, Bänder einer physischen Seite zum Rendern an den Treiber zu senden.

Syntax

BOOL DrvStartBanding(
  [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 ersten Bandes zu empfangen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte die Win32 SetLastError-Funktion 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 DrvStartBanding nur auf, wenn die DrvEnableSurface-Funktion der Druckergrafik-DLL zuvor EngMarkBandingSurface genannt wurde, um eine Bandingoberfläche anzugeben.

Der Zweck der DrvStartBanding-Funktion besteht darin, der Druckergrafik-DLL zu ermöglichen, alle erforderlichen Initialisierungen auszuführen, bevor Bandingvorgänge auf einer physischen Seite beginnen, und GDI die Indizes des Ursprungs des ersten Bandes bereitzustellen.

Die DrvStartBanding-Funktion wird einmal pro Seite aufgerufen. Jedes Mal, wenn GDI das Zeichnen eines Bandes abgeschlossen hat, wird DrvNextBand aufgerufen, damit der Treiber das Band an den Drucker senden kann.