Функция 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 | Нет | |
| Замечания по платформе | Не имеется | |