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 条目的关键字参数。

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

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

要求

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