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 在 指向的位置提供所需的缓冲区大小,返回E_FAIL,并将错误代码设置为ERROR_INSUFFICIENT_BUFFER。

要求

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