IPrintOemUI::D evicePropertySheets 方法 (prcomoem.h)

方法 IPrintOemUI::DevicePropertySheets 允许用户界面插件将新页面追加到打印机设备的打印机属性表。

语法

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

参数

pPSUIInfo

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

lParam

调用方提供的值,该值取决于 pPSUIInfo-->Reason 中的原因值。 原因值可以是以下常量之一,这些常量在 compstui.h 中定义。 有关这些常量的详细信息,请参阅 PFNPROPSHEETUI 函数类型中的“备注”部分和 lParam 参数说明。

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

返回值

返回值取决于PROPSHEETUI_INFO结构的 Reason 成员的内容。 有关详细信息,请参阅 DrvDevicePropertySheets 的说明

注解

用户界面插件的 IPrintOemUI::DevicePropertySheets 方法执行的操作类型与用户模式打印机接口 DLL 导出的 DrvDevicePropertySheets 函数相同。 这两个函数具有相同的输入参数。

如果提供用户界面插件,则会 IPrintOemUI::DevicePropertySheets 在调用驱动程序的 DrvDevicePropertySheets 函数后调用 方法。

调用 时IPrintOemUI::DevicePropertySheetsPROPSHEETUI_INFO 结构的 lParamInit 成员包含 OEMUIPSPARAM 结构的地址。

如果实现此方法,通常还会提供 _CPSUICALLBACK类型的回调函数来处理用户修改。 如果值存储在驱动程序的 DEVMODEW 结构 (而不是插件的专用 DEVMODEW 成员) 或注册表项中,则此回调函数必须调用 IPrintOemDriverUI::D rvUpdateUISetting 以通知驱动程序与用户界面设置关联的值。

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

如果一个用户界面插件支持多个打印机型号,并且你只希望为其中一些模型显示新页面,则 IPrintOemUI::DevicePropertySheets 该方法应仅为不需要页面的模型提供成功返回值,而不实际添加页面。

有关创建和安装用户界面插件的详细信息,请参阅 自定义 Microsoft 打印机驱动程序

要求

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

另请参阅

DrvDevicePropertySheets

IPrintOemUI

IPrintOemUI::D ocumentPropertySheets

PFNPROPSHEETUI