IPrintOemUni2::WritePrinter 方法(prcomoem.h)

IPrintOemUni2::WritePrinter 方法(如果受支持)使呈现插件能够捕获 Unidrv 驱动程序生成的所有输出数据。 如果不支持此方法,则输出数据将在调用后台处理程序的 WritePrinter API(Microsoft Windows SDK 文档中所述)时发送到后台处理程序。

语法

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

参数

pdevobj

指向 DEVOBJ 结构的指针。

pBuf

指向包含 Unidrv 驱动程序生成的输出数据的字节数组的第一个字节的指针。

cbBuffer

指定由 pBuf指向的数组的大小(以字节为单位)。

pcbWritten

指向 DWORD 值的指针,该值接收成功发送到插件的数据字节数。

返回值

如果成功,此方法将返回S_OK。 否则,此方法应在返回的 HRESULT 中返回适当的值。

言论

DrvEnablePDEV 时,Unidrv 驱动程序调用此方法时,pBufpdevobj 设置为 NULLcbBuf 设置为 0,以检测插件是否实现此函数。 插件应返回S_OK,以指示它实现此方法,否则应返回E_NOTIMPL。

此方法应报告写入后台处理程序的 WritePrinter 函数 中的字节数。 零值没有特殊含义;必须通过返回的 HRESULT 报告错误。

IPrintOemUni2::WritePrinter 方法是可选的。 如果呈现插件实现此方法,则插件的 IPrintOemUni::GetImplementedMethod 方法在收到“WritePrinter”作为输入时必须返回S_OK。

要求

要求 价值
目标平台 桌面
标头 prcomoem.h (include Prcomoem.h)