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

Die IPrintOemDriverUni::DrvWriteAbortBuf-Methode wird vom Unidrv-Treiber bereitgestellt, damit ein OEM-Rendering-Plug-In- druckerbereinigungscode 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 durch pBufferverwiesen wird.

dwWait

Die vom Anrufer bereitgestellte Zeitdauer, die der Drucker in Millisekunden warten muss, bevor ein neuer Druckauftrag gestartet werden 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 war erfolgreich.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Bemerkungen

OEMs verwenden IPrintOemDriverUni::D rvWriteSpoolBuf zum Senden der Ausgabe an den Drucker. Wenn ein Druckauftrag vom Benutzer beendet wird, gibt IPrintOemDriverUni::DrvWriteSpoolBuf E_FAIL zurück und kann nicht mehr zum Senden von Daten an den Drucker verwendet werden. In diesem Fall müssen bestimmte Drucker über ein bereinigungsbasiertes Codefragment verfügen, das ihre Zustände zurückgesetzt hat, bevor sie neue Druckaufträge starten können. Für diese Drucker wird IPrintOemDriverUni::DrvWritetAbortBuf verwendet, um dieses Codefragment an den Drucker zu senden.

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

Rendering-Plug-Ins werden in Anpassen der Druckertreiber von Microsoftbeschrieben.

Anforderungen

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