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)

Weitere Informationen

DrvSendPage

EngWritePrinter