Функция 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:

Версия этой функции Юникода — CMCreateProfileW.

Для экспорта этой функции требуется только CMM по умолчанию Для Windows; Это необязательно для всех остальных CMM.

Если CMM не поддерживает CMCreateProfile, Windows использует CMM по умолчанию для создания профиля.

CMM должен задать для всех полей заголовка разумные значения по умолчанию. Этот профиль должен использоваться в качестве входного профиля в преобразовании.

Вызывающее приложение должно освободить буфер, выделенный этой функцией, и указывать на параметр lpProfileData . Используйте GlobalFree для освобождения буфера.

Требования

См. также

• Основные понятия управления цветами
• Функции
• CMCreateProfileW