通过

IPrintOemUI：：CommonUIProp 方法（prcomoem.h）

  • 项目

IPrintOemUI::CommonUIProp 方法允许用户界面插件修改现有的打印机属性表页。

语法

HRESULT CommonUIProp(
  DWORD         dwMode,
  POEMCUIPPARAM pOemCUIPParam
);

参数

dwMode

调用方提供的整数常量，指示应修改哪些属性表页。 以下常量有效。

价值 定义
OEMCUIP_DOCPROP 调用此方法以修改文档属性表的“布局”、“纸张/质量”或“高级”页。
OEMCUIP_PRNPROP 正在调用该方法以修改打印机属性表的设备设置页。

pOemCUIPParam

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

返回值

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

返回代码 描述
S_OK
 作成功。
E_FAIL
 作失败。
E_NOTIMPL
 未实现该方法。

言论

调用用户界面插件的 IPrintOemUI::CommonUIProp 方法时，它应返回自定义的属性表选项项，以便修改现有的打印机属性表页。

IPrintOemUI::CommonUIProp 方法由打印机驱动程序的 打印机接口 DLL调用。 该方法应提供描述属性表项的 OPTITEM 结构的数组，以及用于处理用户修改选项值的回调函数。

应该要求为每个属性表调用两次方法。 方法的 dwMode 参数值指示是调用它来更改打印机属性表还是文档属性表。

第一次调用该方法时，该方法应只返回要添加 OPTITEM 结构的数量。 此数字应放置在 OEMCUIPPARAM 结构的 cOEMOptItems 成员 中。 然后，打印机接口 DLL 分配足够的内存来存储指定的 OPTITEM 数，并再次调用 IPrintOemUI::CommonUIProp。

第二次调用该方法时，IPrintOemUI::CommonUIProp 方法应执行以下作：

  • 使用选项说明填充驱动程序提供的 OPTITEM 结构的数组。 此数组由 OEMCUIPPARAM 结构的 pOEMOptItems 成员指向，分配的数组元素数包含在结构的 cOEMOptItems 成员中。 （有关指定 OPTITEM 成员值的信息，请参阅 OEMCUIPPARAM 结构的 pOEMOptItems 成员的说明）。
  • 通过将数字放置在 OEMCUIPPARAM 结构的 cOEMOptItems 成员中，返回添加到 OPTITEM 数组的结构数。
  • 返回 OEMCUIPPARAM 结构的 OEMCUIPCallback 成员中回调函数的地址。 当用户修改属性表页时，将调用此回调函数。 回调函数的类型必须 OEMCUIPCALLBACK。
  • （可选）通过将专用数据结构的地址放置在 OEMCUIPPARAM 结构的 pOEMUserData 成员中来返回该地址。 结构 OEMCUIPCallback 成员指定的回调函数接收 OEMCUIPPARAM 结构的地址作为输入参数，因此可以获取专用数据的地址。

    应通过使用 OEMCUIPPARAM 结构的 hOEMHeapHeap 成员中包含的句柄调用 Microsoft Windows SDK HeapAlloc 函数来分配专用数据结构的空间。

如果 IPrintOemUI::CommonUIProp 方法由多个用户界面插件导出，则按照为安装指定插件的顺序调用这些方法。

有关详细信息，请参阅 修改 Driver-Supplied 属性表页。

要求

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