Freigeben über


DrvStartBanding-Funktion (winddi.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvEnableSurface

DrvNextBand

EngMarkBandingSurface