DrvStartPage-Funktion (winddi.h)
Die DrvStartPage-Funktion wird von GDI aufgerufen, wenn sie bereit ist, den Inhalt einer physischen Seite zum Rendern an den Treiber zu senden.
Syntax
BOOL DrvStartPage(
[in] SURFOBJ *pso
);
Parameter
[in] pso
Vom Aufrufer bereitgestellter Zeiger auf eine SURFOBJ-Struktur .
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
Eine Druckergrafik-DLL muss eine DrvStartPage-Funktion bereitstellen. Die Funktion wird aufgerufen, bevor jede physische Seite eines Druckauftrags gerendert wird. (Eine physische Seite kann eine oder mehrere Dokumentseiten enthalten.)
In der Regel wird die Funktion verwendet, um Steuersequenzen an Druckerhardware zu senden, bevor eine Seite gedruckt wird, indem die EngWritePrinter-Funktion von GDI aufgerufen wird. Die Funktion kann auch interne, seitenspezifische Initialisierungsvorgänge für die Druckergrafik-DLL ausführen.
Anforderungen
Zielplattform | Desktop |
Kopfzeile | winddi.h (einschließlich Winddi.h) |