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
在当前作业中止后,打印机在启动新的打印作业之前,打印机必须等待的时间长度(以毫秒为单位)。
返回值
方法必须返回以下值之一。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
此操作失败。 |
|
该方法未实现。 |
注解
OEM 使用 IPrintOemDriverUni::D rvWriteSpoolBuf 将输出发送到打印机。 如果用户终止打印作业, IPrintOemDriverUni::DrvWriteSpoolBuf
则返回E_FAIL,并且不再可用于向打印机发送任何数据。 发生这种情况时,某些打印机必须向其发送清理代码片段,重置其状态,然后才能启动新的打印作业。 对于这些打印机, IPrintOemDriverUni::DrvWritetAbortBuf
用于将此代码片段发送到打印机。
IPrintOemDriverUni::DrvWriteAbortBuf
只能在返回E_FAIL后 IPrintOemDriverUni::DrvWriteSpoolBuf
调用。 IPrintOemDriverUni::DrvWriteAbortBuf
不应为每个作业多次调用。
自定义 Microsoft 的打印机驱动程序中介绍了呈现插件。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |