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

Zeiger auf das erste Byte eines Arrays von Bytes, das die vom Unidrv-Treiber generierten Ausgabedaten enthält.

cbBuffer

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

pcbWritten

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

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Methode S_OK zurück. Andernfalls sollte diese Methode einen entsprechenden Wert im zurückgegebenen HRESULT zurückgeben.

Hinweise

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

Diese Methode sollte die Anzahl der Bytes melden, die in die WritePrinter-Funktion des Spoolers in pcbWritten geschrieben 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 des Plug-Ins S_OK zurückgeben, wenn es "WritePrinter" als Eingabe empfängt.

Anforderungen

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