StartDocPrinter függvény

A StartDocPrinter függvény értesíti a nyomtatásisor-kezelőt, hogy a dokumentumot nyomtatási sorba kell tenni.

Szemantika

DWORD StartDocPrinter(
  _In_ HANDLE hPrinter,
  _In_ DWORD  Level,
  _In_ LPBYTE pDocInfo
);

Paraméterek

hPrinter [in]

Egy fogópont a nyomtatóhoz. Nyomtatófogópont lekéréséhez használja az OpenPrinter vagy az AddPrinter függvényt.

szint [in]

Annak a struktúranak a verziója, amelyre a pDocInfo mutat. Ennek az értéknek 1-nek kell lennie.

pDocInfo [in]

A nyomtatandó dokumentumot leíró DOC_INFO_1 szerkezetre mutató mutató.

Visszaadott érték

Ha a függvény sikeres, a visszatérési érték azonosítja a nyomtatási feladatot.

Ha a függvény sikertelen, a visszatérési érték nulla.

Megjegyzések

Megjegyzés:

Ez egy blokkoló vagy szinkron függvény, és előfordulhat, hogy nem azonnal tér vissza. A függvény visszatérési ideje olyan futásidejű tényezőktől függ, mint a hálózati állapot, a nyomtatókiszolgáló konfigurációja és a nyomtatóillesztő implementálási tényezői, amelyeket nehéz előrejelezni az alkalmazások írásakor. Ha ezt a függvényt egy olyan szálról hívja meg, amely kezeli a felhasználói felülettel való interakciót, az alkalmazás nem válaszolhat.

A nyomtatási feladatok jellemző sorrendje a következő:

1. Nyomtatási feladat indításához hívja meg a StartDocPrintert.
2. Az egyes lapok indításához hívja meg a StartPagePrintert.
3. Ha adatokat szeretne írni egy lapra, hívja meg a WritePrintert.
4. Az egyes lapok befejezéséhez hívja meg az EndPagePrintert.
5. Ismételje meg a 2, 3 és 4 elemet a szükséges számú oldal esetében.
6. A nyomtatási feladat befejezéséhez hívja meg az EndDocPrintert.

Vegye figyelembe, hogy előfordulhat, hogy a StartPagePrinter és az EndPagePrinter meghívása nem szükséges, például ha a nyomtatási adattípus tartalmazza az oldaladatokat.

Ha egy többsoros fájlban lévő lap mérete meghaladja a 350 MB-ot, a lap nyomtatása sikertelen lehet, és nem küld hibaüzenetet. Ez például nagy EMF-fájlok nyomtatásakor fordulhat elő. Az oldalméret korlátja számos tényezőtől függ, például a rendelkezésre álló virtuális memória mennyiségétől, a hívási folyamatok által lefoglalt memória mennyiségétől és a folyamat halomtöredezettségének mennyiségétől.

Példák

A függvényt használó mintaprogramokkal kapcsolatban lásd : Útmutató: Nyomtatás a GDI Print API használatával.

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows 2000 Professional [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows 2000 Server [csak asztali alkalmazások]
Fejléc	Winspool.h (a Windows.h-t is tartalmazza)
Könyvtár	Winspool.lib
DLL	Winspool.drv
Unicode- és ANSI-nevek	StartDocPrinterW (Unicode) és StartDocPrinterA (ANSI)

Lásd még

Feladat hozzáadása

DOC_INFO_1

DOC_INFO_2

EndDocPrinter

EndPagePrinter

OpenPrinter

Nyomtatás

Nyomtatásisor-kezelő API Functions

StartLapNyomtató

WritePrinter