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

  • 项目

方法 IPrintOemDriverUni::DrvGetGPDData 由 Unidrv 驱动程序提供，以便呈现插件可以获取打印机 的 GPD 文件中定义的数据。

语法

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

参数

pdevobj

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

dwType

调用方提供的标志，指示所请求的 GPD 数据类型。 目前，以下标志是唯一定义的标志：

标志 定义
GPD_OEMCUSTOMDATA 方法返回与 GPD 文件的 *OEMCustomData 条目关联的字符串。

pInputData

保留。 必须为零。

pBuffer

调用方提供的指向缓冲区的指针，用于接收请求的信息。

cbSize

pBuffer 指向的缓冲区的调用方提供的大小（以字节为单位）。

pcbNeeded

接收驱动程序提供的最小缓冲区大小（以字节为单位），以包含请求的信息。

返回值

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

返回代码 说明
S_OK
 操作成功。
E_FAIL
 此操作失败。
E_NOTIMPL
 该方法未实现。

注解

如果 pBuffer 和 cbSize 指定的缓冲区太小，无法接收请求的信息，则 Unidrv 会在 由印刷板Needed 指向的位置提供所需的缓冲区大小，返回E_FAIL，并将错误代码设置为ERROR_INSUFFICIENT_BUFFER。

要求

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