Méthode IPrintOemPS2 ::WritePrinter (prcomoem.h)

La IPrintOemPS2::WritePrinter méthode, si elle est prise en charge, permet à un plug-in de rendu de capturer toutes les données de sortie générées par un pilote Postscript. Si cette méthode n’est pas prise en charge, les données de sortie sont sinon envoyées au spouleur dans un appel à l’API WritePrinter du spouleur (décrite dans la documentation Microsoft Windows SDK).

Syntaxe

HRESULT WritePrinter(
  PDEVOBJ pdevobj,
  PVOID   pBuf,
  DWORD   cbBuffer,
  PDWORD  pcbWritten
);

Paramètres

pdevobj

Pointeur vers une structure DEVOBJ .

pBuf

Pointeur vers le premier octet d’un tableau d’octets qui contient les données de sortie générées par le pilote PostScript.

cbBuffer

Spécifie la taille, en octets, du tableau pointé par pBuf.

pcbWritten

Pointeur vers une valeur DWORD qui reçoit le nombre d’octets de données que le plug-in a envoyé à la fonction WritePrinter du spouleur (décrit dans la documentation du Kit de développement logiciel (SDK) Windows.

Valeur retournée

Si elle réussit, cette méthode retourne S_OK. Sinon, cette méthode doit retourner une valeur appropriée dans le HRESULT retourné.

Remarques

Au moment de DrvEnablePDEV , le pilote PostScript appelle cette méthode avec pBuf et pdevobj définis sur NULL et cbBuf sur 0, pour détecter si le plug-in implémente cette fonction. Le plug-in doit retourner S_OK pour indiquer qu’il implémente cette méthode et doit retourner E_NOTIMPL sinon.

Cette méthode doit signaler le nombre d’octets écrits dans la fonction WritePrinter du spouleur dans pcbWritten. Une valeur de zéro n’a aucune signification particulière ; les erreurs doivent être signalées via le HRESULT retourné.

Configuration requise