通过

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 （include Prcomoem.h）