Fonction EngWritePrinter (winddi.h)
La fonction EngWritePrinter permet aux DLL graphiques d’imprimante d’envoyer un flux de données au matériel de l’imprimante.
Syntaxe
ENGAPI BOOL EngWritePrinter(
[in] HANDLE hPrinter,
[in] LPVOID pBuf,
[in] DWORD cbBuf,
[out] LPDWORD pcWritten
);
Paramètres
[in] hPrinter
Handle fourni par l’appelant à l’imprimante. Il doit s’agir du handle reçu en tant que valeur de paramètre hDriver de la fonction DrvEnablePDEV.
[in] pBuf
Pointeur fourni par l’appelant vers une mémoire tampon contenant un flux d’octets à envoyer à l’imprimante.
[in] cbBuf
Spécifie le nombre d’octets fournis par l’appelant contenu dans la mémoire tampon pointée par pBuf.
[out] pcWritten
Pointeur fourni par l’appelant vers un emplacement DWORD qui reçoit le nombre d’octets réellement écrits sur l’imprimante.
Valeur retournée
Si l’opération réussit, la fonction retourne TRUE ; sinon, il retourne FALSE.
Remarques
Les DLL graphiques d’imprimanteappellent EngWritePrinter pour envoyer des flux de données (séquences de contrôle ou données d’image) au spouleur d’impression, qui à son tour envoie les données au matériel d’imprimante en appelant le moniteur d’impression approprié. La fonction retourne une fois que le spouleur a reçu les données.
La mémoire tampon pointée par pBuf ne peut pas se trouver dans la mémoire utilisateur ; autrement dit, pBuf ne peut pas pointer vers la mémoire allouée par EngCreateBitmap avec l’indicateur BMF_USERMEM défini ou par EngAllocUserMem.
Pour plus d’informations sur l’appel d’EngWritePrinter, consultez Rendu d’un travail d’impression.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |