IPrintOemUI::QueryColorProfile 方法 (prcomoem.h)

方法 IPrintOemUI::QueryColorProfile 允许用户界面插件指定用于颜色管理的 ICC 配置文件。

语法

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

参数

hPrinter

调用方提供的打印机句柄。

poemuiobj

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

pPublicDM

调用方提供的指向已验证 DEVMODEW 结构的指针。

pOEMDM

调用方提供的指向用户界面插件的专用 DEVMODEW 结构成员的指针。

ulQueryMode

以下调用方提供的位标志之一,指示要指定的配置文件的类型。

标志 定义
QCP_DEVICEPROFILE 调用方正在请求设备配置文件。
QCP_SOURCEPROFILE 调用方正在请求源配置文件。

pvProfileData

调用方提供的指向缓冲区的指针,用于接收配置文件信息。

pcbProfileData

调用方提供的指针,指向表示 pvProfileData 指向的缓冲区的大小(以字节为单位)的值。

pflProfileData

以下方法提供的位标志之一,指示方法返回的信息类型。

标志 定义
QCP_PROFILEDISK 方法返回 pvProfileData 指向的缓冲区中 ICC 配置文件的文件名。
QCP_PROFILEMEMORY 方法返回 pvProfileData 指向的缓冲区中的配置文件数据。

返回值

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

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

注解

用户界面插件的 IPrintOemUI::QueryColorProfile 方法执行的操作类型与用户模式打印机接口 DLL 导出的 DrvQueryColorProfile 函数相同。 有关打印机事件及其处理方式的信息,请参阅 DrvQueryColorProfile 函数的说明。

如果提供用户界面插件,打印机驱动程序的 DrvQueryColorProfile 函数将调用 IPrintOemUI::QueryColorProfile 方法。 DrvQueryColorProfile 函数对指定事件执行自己的处理,然后调用 IPrintOemUI::QueryColorProfile 方法来处理事件的其他处理。

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

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

要求

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