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

  • 项目

方法 IPrintOemDriverUni::DrvWriteAbortBuf 由 Unidrv 驱动程序提供，以允许 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 用于将此代码片段发送到打印机。

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

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

要求

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