Функция CMCreateTransformExt

Функция ANSI CMCreateTransformExt создает преобразование цвета, которое отображается из входной структуры LOGCOLORSPACE в дополнительное целевое пространство, а затем на устройство вывода данных, используя ряд флажков, которые определяют, как преобразование должно производится.

Синтаксис

HCMTRANSFORM WINAPI CMCreateTransformExt(
  LPLOGCOLORSPACEA lpColorSpace,        // указатель цветового пространства
  LPDEVCHARACTER lpDevCharacter,        // профиль устройства
  LPDEVCHARACTER lpTargetDevCharacter,  // целевой профиль
  DWORD dwFlags                         // флажки создания
);

Параметры

lpColorSpace

Указатель на входную структуру логического цветового пространства.

lpDevCharacter

Указатель на отображаемый в памяти профиль устройства.

lpTargetDevCharacter

Указатель на отображаемый в памяти целевой профиль.

dwFlags

Определяет флажки используемые для управления созданием преобразования. Детали смотри в статье Создающие преобразование флажки Модуля управления цветом (CMM).

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

Если эта функция завершается успешно, возвращаемое значение - значение преобразованного цвета в диапазоне 256 - 65 535. Так как сохраняется только младшее слово (WORD) преобразования, допустимые значения преобразования не могут выйти за пределы этого диапазона.

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

Замечания

Эквивалент Unicode CMCreateTransformExt - CMCreateTransformExtW.

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

Смотри также

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

Размещение и совместимость CMCreateTransformExt
К	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		Нет
Замечания по платформе		Не имеется