IPrintOemDriverUni::D rvWriteAbortBuf 方法(prcomoem.h)

Unidrv 驱动程序提供 IPrintOemDriverUni::DrvWriteAbortBuf 方法,以允许 OEM 呈现插件 在用户终止打印作业后发送打印机清理代码。

语法

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

参数

pdevobj

调用方提供的指向 DEVOBJ 结构的指针。

pBuffer

调用方提供的指向包含要发送到打印机的代码片段的缓冲区的指针。

cbSize

pBuffer指向的缓冲区中调用方提供的字节数。

dwWait

打印机必须等待的时间长度(以毫秒为单位),然后才能在中止当前作业后启动新的打印作业。

返回值

该方法必须返回以下值之一。

返回代码 描述
S_OK
作成功。
E_FAIL
作失败。
E_NOTIMPL
未实现该方法。

言论

OEM 使用 IPrintOemDriverUni::D rvWriteSpoolBuf 将输出发送到打印机。 如果用户终止打印作业,IPrintOemDriverUni::DrvWriteSpoolBuf 将返回E_FAIL,并且不能再用于向打印机发送任何数据。 发生这种情况时,某些打印机必须向其发送清理代码片段,重置其状态,然后才能启动新的打印作业。 对于这些打印机,IPrintOemDriverUni::DrvWritetAbortBuf 用于将此代码片段发送到打印机。

只能在返回E_FAIL IPrintOemDriverUni::DrvWriteSpoolBuf 后调用 IPrintOemDriverUni::DrvWriteAbortBuf。 每个作业不应多次调用 IPrintOemDriverUni::DrvWriteAbortBuf

自定义Microsoft打印机驱动程序中介绍了呈现插件。

要求

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