Функция CreateProfileFromLogColorSpaceA (icm.h)

Преобразует логическое цветовое пространство в профиль устройства.

Syntax

BOOL CreateProfileFromLogColorSpaceA(
  LPLOGCOLORSPACEA pLogColorSpace,
  PBYTE            *pProfile
);

Parameters

pLogColorSpace

Указатель на структуру логического цветового пространства. Дополнительные сведения см. в разделе LOGCOLORSPACEA . Элемент lcsFilename [0] структуры должен иметь значение NULL ('\0'), или этот вызов функции завершится ошибкой с возвращаемым значением INVALID_PARAMETER.

pProfile

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

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

Если эта функция выполнена успешно, возвращаемое значение равно TRUE.

Если эта функция завершается ошибкой, возвращаемое значение равно FALSE.

Если элемент lcsFilename [0], если структура LOGCOLORSPACEA , на которую указывает pLogColorSpace , не является "\0", эта функция возвращает INVALID_PARAMETER.

Замечания

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

Эта функция не поддерживает профили Windows цветовой системы (WCS) CAMP, DMP и GMMP.

Требования

См. также

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