IPrintOemDriverUI：:D rvGetDriverSetting 方法 (prcomoem.h)

  • 项目

方法 IPrintOemDriverUI::DrvGetDriverSetting 由 Unidrv 和 Pscript5 微型驱动程序提供，以便用户界面插件可以获取打印机功能的当前状态和其他内部信息。

语法

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

参数

pci

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

Feature

调用方提供的值，用于标识为其返回选项设置的打印机功能。 这可以是字符串指针或常量，如以下备注部分所述。

pOutput

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

cbSize

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

pcbNeeded

调用方提供的指向位置的指针，用于接收包含所请求信息所需的最小缓冲区大小。

pdwOptionsReturned

调用方提供的指向位置的指针，用于接收 放置在 pOutput 中的选项字符串数。

返回值

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

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

注解

调用 IPrintOemDriverUI::DrvGetDriverSetting 方法时，用户界面插件可以为 pFeatureKeyword 指定字符串指针或常量值。

  • 如果 pFeatureKeyword 是字符串，则它必须表示下列值之一：
    • Unidrv 微型驱动程序 GPD 文件中指定的功能名称，或者
    • Pscript5 微型驱动程序的 PPD 文件中 *OpenUI 项的关键字 (keyword) 参数。

    方法在 pOutput 指向的缓冲区中返回一个或多个以 NULL 结尾的字符串。 每个字符串表示当前所选选项的名称。在 pdwOptionsReturned 中返回字符串数。

  • 如果 pFeatureKeyword 是常量，则它必须是 printoem.h 中定义的 OEMGDS_前缀常量之一。 方法通过将指定的常量放置在 pOutput 指向的缓冲区中，返回指定的常量指示的值。 pdwOptionsReturned 中返回的值始终为 1。

要求

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