IPrintOemUni2::WritePrinter-Methode (prcomoem.h)

Die IPrintOemUni2::WritePrinter-Methode ermöglicht es einem Rendering-Plug-In, alle Ausgabedaten zu erfassen, die von einem Unidrv-Treiber generiert werden. Wenn diese Methode nicht unterstützt wird, werden die Ausgabedaten andernfalls in einem Aufruf der WritePrinter-API des Spoolers an den Spooler gesendet (in der Microsoft Windows SDK-Dokumentation beschrieben).

Syntax

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

Parameter

pdevobj

Zeiger auf eine DEVOBJ--Struktur.

pBuf

Zeigen Sie auf das erste Byte eines Bytearrays, das die vom Unidrv-Treiber generierten Ausgabedaten enthält.

cbBuffer

Gibt die Größe des Arrays in Bytes an, auf das durch pBuf-verwiesen wird.

pcbWritten

Zeiger auf einen DWORD-Wert, der die Anzahl der Daten empfängt, die erfolgreich an das Plug-In gesendet wurden.

Rückgabewert

Wenn die Methode erfolgreich verläuft, werden S_OK zurückgegeben. Andernfalls sollte diese Methode einen geeigneten Wert im zurückgegebenen HRESULT zurückgeben.

Bemerkungen

Bei DrvEnablePDEV Zeit ruft der Unidrv-Treiber diese Methode mit pBuf- und pdevobj- auf NULL-festgelegt und cbBuf auf 0 festgelegt, um zu ermitteln, ob das Plug-In diese Funktion implementiert. Das Plug-In sollte S_OK zurückgeben, um anzugeben, dass es diese Methode implementiert, und es sollte E_NOTIMPL andernfalls zurückgegeben werden.

Diese Methode sollte die Anzahl der Bytes melden, die in die WritePrinter--Funktion des Spoolers in pcbWrittengeschrieben wurden. Ein Wert von Null hat keine besondere Bedeutung; Fehler müssen über das zurückgegebene HRESULT gemeldet werden.

Die IPrintOemUni2::WritePrinter-Methode ist optional. Wenn ein Rendering-Plug-In diese Methode implementiert, muss die IPrintOemUni::GetImplementedMethod--Methode S_OK zurückgeben, wenn es "WritePrinter" als Eingabe empfängt.

Anforderungen

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