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) |