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

Voir aussi

DrvEnablePDEV

EngAllocUserMem

EngCreateBitmap