IPrintOemDriverUni::D rvWriteAbortBuf-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintOemDriverUni::DrvWriteAbortBuf -Methode wird vom Unidrv-Treiber bereitgestellt, damit ein OEM-Rendering-Plug-In Druckercode sauber-Up-Code senden kann, nachdem ein Benutzer einen Druckauftrag beendet hat.

Syntax

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

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

pBuffer

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der ein Codefragment enthält, das an den Drucker gesendet werden soll.

cbSize

Vom Aufrufer bereitgestellte Anzahl von Bytes im Puffer, auf die von pBuffer verwiesen wird.

dwWait

Die vom Aufrufer bereitgestellte Zeitspanne, die der Drucker in Millisekunden warten muss, bevor er einen neuen Druckauftrag starten kann, nachdem der aktuelle Auftrag abgebrochen wurde.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

OEMs verwenden IPrintOemDriverUni::D rvWriteSpoolBuf , um die Ausgabe an den Drucker zu senden. Wenn ein Druckauftrag vom Benutzer beendet wird, IPrintOemDriverUni::DrvWriteSpoolBuf gibt E_FAIL zurück und kann nicht mehr zum Senden von Daten an den Drucker verwendet werden. In diesem Fall muss bei bestimmten Druckern ein sauber Codefragment gesendet werden, das ihre Zustände zurückgesetzt, bevor sie neue Druckaufträge starten können. Für diese Drucker wird verwendet, IPrintOemDriverUni::DrvWritetAbortBuf um dieses Codefragment an den Drucker zu senden.

IPrintOemDriverUni::DrvWriteAbortBuf kann nur aufgerufen werden, nachdem IPrintOemDriverUni::DrvWriteSpoolBuf E_FAIL zurückgegeben wurde. IPrintOemDriverUni::DrvWriteAbortBuf sollte nicht mehr als einmal pro Auftrag aufgerufen werden.

Rendering-Plug-Ins werden unter Anpassen der Druckertreiber von Microsoft beschrieben.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (einschließlich Prcomoem.h)

Freigeben über