CreateDeviceLinkProfile 函数 (icm.h)

  • 项目

使用指定的意向从一组颜色配置文件创建国际颜色联盟 (ICC) 设备链接配置文件 。

语法

BOOL CreateDeviceLinkProfile(
  PHPROFILE hProfile,
  DWORD     nProfiles,
  PDWORD    padwIntent,
  DWORD     nIntents,
  DWORD     dwFlags,
  PBYTE     *pProfileData,
  DWORD     indexPreferredCMM
);

parameters

hProfile

指向要使用的颜色配置文件句柄数组的指针。 函数确定 HPROFILE 是否包含 ICC 配置文件信息，如果包含，则相应地处理它们。

nProfiles

指定 hProfile 指向的数组中的配置文件数。

padwIntent

指向包含要使用的意向的 DWORDS 数组的指针。 请参阅 呈现意向。

nIntents

padwIntent 指向的数组中的意向数。

dwFlags

指定用于创建转换的控件的标志。 有关详细信息，请参阅 CMM 转换创建标志。

pProfileData

指向指向缓冲区的指针的指针。 如果成功，此函数将分配缓冲区，将其地址置于 *pProfileData 中，并使用设备链接配置文件填充该缓冲区。 如果函数成功，调用应用程序必须在不再需要缓冲区后释放缓冲区。

indexPreferredCMM

指定颜色配置文件的从 1 开始的索引，该索引指示要使用的 CMM) (颜色管理模块。 应用程序开发人员可以通过将此参数设置为 INDEX_DONT_CARE 来允许 Windows 选择 CMM。 请参阅 (CMM) 使用颜色管理模块 。

返回值

如果此函数成功，则返回值为非零值。

如果此函数失败，则返回值为零。 有关扩展的错误信息，请调用 GetLastError。

注解

对于包含 WCS 配置文件信息的 HPROFILE，HPROFILEs 将转换为有效的 ICC 配置文件句柄，然后在创建设备链接配置文件时使用这些 ICC 配置文件句柄。

数组中的第一个和最后一个配置文件必须是设备配置文件。 其他配置文件可以是颜色空间或抽象配置文件。

每个配置文件的输出颜色空间必须是下一个配置文件的输入颜色空间。

调用应用程序必须释放此函数分配并由 pProfileData 参数指向的缓冲区。 应使用 GlobalFree 函数来释放缓冲区。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅