Функция 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, чтобы освободить буфер.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |