Méthode IPrintOemDriverUni ::D rvWriteAbortBuf (prcomoem.h)

Article
02/27/2024

La IPrintOemDriverUni::DrvWriteAbortBuf méthode est fournie par le pilote Unidrv pour permettre à un plug-in de rendu OEM d’envoyer du code propre d’imprimante après la fin d’un travail d’impression par un utilisateur.

Syntaxe

HRESULT DrvWriteAbortBuf(
  PDEVOBJ pdevobj,
  PVOID   pBuffer,
  DWORD   cbSize,
  DWORD   dwWait
);

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ .

pBuffer

Pointeur fourni par l’appelant vers une mémoire tampon contenant un fragment de code à envoyer à l’imprimante.

cbSize

Nombre d’octets fournis par l’appelant dans la mémoire tampon pointée par pBuffer.

dwWait

La durée fournie par l’appelant doit attendre, en millisecondes, avant de pouvoir démarrer un nouveau travail d’impression après l’abandon du travail actuel.

Valeur retournée

La méthode doit retourner l’une des valeurs suivantes.

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L'opération a échoué.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

Les fabricants OEM utilisent IPrintOemDriverUni ::D rvWriteSpoolBuf pour envoyer la sortie à l’imprimante. Si un travail d’impression est arrêté par l’utilisateur, IPrintOemDriverUni::DrvWriteSpoolBuf retourne E_FAIL et ne peut plus être utilisé pour envoyer des données à l’imprimante. Lorsque cela se produit, un fragment de code propre-up doit être envoyé à certaines imprimantes, ce qui leur permet de réinitialiser leurs états avant de pouvoir démarrer de nouveaux travaux d’impression. Pour ces imprimantes, IPrintOemDriverUni::DrvWritetAbortBuf est utilisé pour envoyer ce fragment de code à l’imprimante.

IPrintOemDriverUni::DrvWriteAbortBuf ne peut être appelé qu’après IPrintOemDriverUni::DrvWriteSpoolBuf avoir retourné E_FAIL. IPrintOemDriverUni::DrvWriteAbortBuf ne doit pas être appelé plus d’une fois par travail.

Les plug-ins de rendu sont décrits dans Personnalisation des pilotes d’imprimante de Microsoft.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (include Prcomoem.h)

Partager via