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 |