StartPagePrinter-funktion

Funktionen StartPagePrinter meddelar bufferten att en sida håller på att skrivas ut på den angivna skrivaren.

Syntax

BOOL StartPagePrinter(
  _In_ HANDLE hPrinter
);

Parameterar

hPrinter [in]

Hantera till en skrivare. Använd funktionen OpenPrinter eller AddPrinter för att hämta ett skrivarhandtag.

Returvärde

Om funktionen lyckas är returvärdet ett värde som inte är noll.

Om funktionen misslyckas är returvärdet noll.

Anmärkningar

Anmärkning

Det här är en blockerande eller synkron funktion och kanske inte returneras omedelbart. Hur snabbt den här funktionen returneras beror på körningsfaktorer som nätverksstatus, utskriftsserverkonfiguration och implementeringsfaktorer för skrivardrivrutiner som är svåra att förutsäga när du skriver ett program. Att anropa den här funktionen från en tråd som hanterar interaktion med användargränssnittet kan göra att programmet verkar inte svara.

Sekvensen för ett utskriftsjobb är följande:

1. Starta ett utskriftsjobb genom att anropa StartDocPrinter.
2. Starta varje sida genom att anropa StartPagePrinter.
3. Om du vill skriva data till en sida anropar du WritePrinter.
4. Avsluta varje sida genom att anropa EndPagePrinter.
5. Upprepa 2, 3 och 4 för så många sidor som behövs.
6. Avsluta utskriftsjobbet genom att anropa EndDocPrinter.

När en sida i en buffrad fil överskrider cirka 350 MB kan den inte skrivas ut och inte skicka ett felmeddelande. Detta kan till exempel inträffa vid utskrift av stora EMF-filer. Sidstorleksgränsen beror på många faktorer, inklusive mängden tillgängligt virtuellt minne, mängden minne som allokeras genom att anropa processer och mängden fragmentering i processens heap.

Exempel

Ett exempelprogram som använder den här funktionen finns i How To: Print Using the GDI Print API (How To: Print Using the GDI Print API).

Kravspecifikation

Krav	Värde
Lägsta klient som stöds	Windows 2000 Professional [endast skrivbordsappar]
Lägsta server som stöds	Windows 2000 Server [endast skrivbordsappar]
Rubrik	Winspool.h (inkludera Windows.h)
Bibliotek	Winspool.lib
DLL	Spoolss.dll

Se även

Utskrift

API-funktioner för utskriftspooler

EndDocPrinter

EndPagePrinter

ÖppnaSkrivare

StartDocPrinter

WritePrinter