EngWritePrinter-Funktion (winddi.h)

Mit der EngWritePrinter-Funktion können Druckergrafik-DLLs einen Datenstrom an Druckerhardware senden.

Syntax

ENGAPI BOOL EngWritePrinter(
  [in]  HANDLE  hPrinter,
  [in]  LPVOID  pBuf,
  [in]  DWORD   cbBuf,
  [out] LPDWORD pcWritten
);

Parameter

[in] hPrinter

Vom Anrufer bereitgestellter Griff zum Drucker. Dies sollte das Handle sein, das als hDriver-Parameterwert der DrvEnablePDEV-Funktion empfangen wird.

[in] pBuf

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der einen Bytestrom enthält, der an den Drucker gesendet werden soll.

[in] cbBuf

Gibt die vom Aufrufer bereitgestellte Anzahl von Bytes an, die im Puffer enthalten sind, auf den pBuf verweist.

[out] pcWritten

Vom Aufrufer bereitgestellter Zeiger auf einen DWORD-Speicherort, der die Anzahl der Bytes empfängt, die tatsächlich in den Drucker geschrieben wurden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Druckergrafik-DLLs rufen EngWritePrinter auf, um Datenströme (entweder Steuersequenzen oder Bilddaten) an den Druckspooler zu senden, der wiederum die Daten an die Druckerhardware sendet, indem der entsprechende Druckmonitor aufgerufen wird. Die Funktion wird zurückgegeben, nachdem der Spooler die Daten empfangen hat.

Der Puffer, auf den pBuf verweist, kann sich nicht im Benutzerspeicher befinden. das heißt, pBuf kann nicht auf den Speicher verweisen, der von EngCreateBitmap mit dem BMF_USERMEM-Flag oder von EngAllocUserMem zugewiesen wurde.

Weitere Informationen zum Aufrufen von EngWritePrinter finden Sie unter Rendern eines Druckauftrags.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

DrvEnablePDEV

EngAllocUserMem

EngCreateBitmap