Функция CMCreateProfile

Функция CMCreateProfile версии ANSI создает профиль цвета дисплея из структуры LOGCOLORSPACE.

Синтаксис

BOOL WINAPI CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,  // указатель на цветовое пространство
  LPBYTE *lpProfileData           // указатель на указатель на буфер
);

Параметры

lpColorSpace

Указатель на логическое цветное пространство, в котором член lcsFilename структуры LOGCOLORSPACE будет НУЛЬ (NULL).

lpProfileData

Указатель на указатель на буфер. В случае успешного завершения функция назначает и заполняет этот буфер. Вызывающее приложение ответственно за освобождение этого буфера, когда он больше не нужен.

Возвращаемые значения

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE).

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Если функция завершается ошибкой, Модуль управления цветом (CMM) должен вызвать функцию SetLastError, чтобы установить код последней ошибки в правильное значение, определенное в Winerror.h.

Замечания

Версия Unicode этой функции - CMCreateProfileW.

Только в Windows Модуль управления цветом (CMM) значения по умолчанию обязан экспортировать эту функцию; она является необязательной для всех других Модулей управления цветом (CMM).

Если Модуль управления цветом (CMM) не поддерживает функцию CMCreateProfile, Windows, чтобы создать профиль, использует Модуль управления цветом (CMM) по умолчанию.

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

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

Смотри также

Обзор Основные концепции управления цветом, Функции, используемые ICM, CMCreateProfileW

Размещение и совместимость CMCreateProfile
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Нет
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Нет
в
е
р
Используемая библиотека		Gdi32.lib
Используемая DLL		-
Заголовочный файл
- объявлено в		Wingdi.h
- включено в		-
Unicode		Нет
Замечания по платформе		Не имеется