CMCreateProfile 函数 (icm.h)

[CMCreateProfile 不再可用于 Windows Vista。]

从 LOGCOLORSPACEA 结构创建显示颜色配置文件。

语法

BOOL CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

参数

lpColorSpace

指向颜色逻辑空间的指针，其中 lcsFilename 成员将为 NULL。

lpProfileData

指向指向缓冲区的指针的指针。 如果成功，函数将分配并填充此缓冲区。 当不再需要此缓冲区时，调用应用程序负责释放该缓冲区。

返回值

从 Windows Vista 开始，默认 CMM (Icm32.dll) 将返回 FALSE，GetLastError 将报告ERROR_NOT_SUPPORTED。

Windows Server 2003、Windows XP 和 Windows 2000：

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

如果此函数失败，则返回值为 FALSE。 调用 GetLastError 以检索错误。

注解

从 Windows Vista 开始，不再需要 CMM 实现程序来实现此方法。

Windows Server 2003、Windows XP 和 Windows 2000：

此函数的 Unicode 版本为 CMCreateProfileW。

导出此函数只需要 Windows 默认 CMM;对于所有其他 CMM，它是可选的。

如果 CMM 不支持 CMCreateProfile，Windows 将使用默认 CMM 来创建配置文件。

CMM 应将所有标头字段设置为合理的默认值。 此配置文件应可作为转换中的输入配置文件使用。

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

要求

另请参阅

• 基本颜色管理概念
• 函数
• CMCreateProfileW