Функция CreateProfileFromLogColorSpace

Функция CreateProfileFromLogColorSpace переделывает логическое цветовое пространство (color space) в профиль устройства (device profile).

Синтаксис

 BOOL WINAPI CreateProfileFromLogColorSpace(
  LPLOGCOLORSPACE pLogColorSpace, 
  PBYTE *pBuffer
);

Параметры

pLogColorSpace

Указатель на структуру логического цветового пространства. Подробности см. в описании LOGCOLORSPACE. В члене структуры lcsFilename [0] должен быть установлен нуль или этот вызов функции завершится ошибкой с возвращаемым значением INVALID_PARAMETER.

pBuffer

Указатель на указатель буфера, где должен быть создан профиль устройства. Эта функция назначает буфер и заполняет его информацией о профиле, если она завершается успешно. В противном случае указатель устанавливается в НУЛЬ (NULL). Вызывающая программа ответственна за то, чтобы освободить этот буфер, когда он больше не нужен.

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

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

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE).

Если член (структуры) lcsFilename [0], и если структура LOGCOLORSPACE указывают, что параметр pLogColorSpace не '\0', то возвращается значение функции INVALID_PARAMETER.

Замечания

Эта функция может использоваться со строками Unicode или ASCII. Буфер, созданный этой функцией должен быть освобожден вызывающей программой, когда он больше не нужен или же будет утечка памяти. Чтобы освободить этот буфер должна использоваться функция GlobalFree.

Смотри также

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

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

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

Назад в оглавление

На главную страницу

В оглавление справки