Функция CMCreateTransformW

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

Синтаксис

HCMTRANSFORM WINAPI CMCreateTransformW(
  LPLOGCOLORSPACEW lpColorSpace,       // указатель на цветовое пространство
  LPDEVCHARACTER lpDevCharacter,       // профиль устройства
  LPDEVCHARACTER lpTargetDevCharacter  // целевой профиль
);

Параметры

lpColorSpace

Указатель на входную структуру логического цветового пространства. Если член lcsFilename структуры COLORSPACEW - не нуль, lpColorSpace - указатель на отображаемый в памяти профиль.

lpDevCharacter

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

lpTargetDevCharacter

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

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

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

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

Замечания

Эквивалент ANSI функции CMCreateTransformW - CMCreateTransform.

Прямое преобразование должно быть уже вычислено перед вызовом этой функции. Будущие вызовы функций перемещения (CMTranslateColors, CMTranslateRGB, CMTranslateRGBs и CMTranslateRGBsExt), использующих прямое преобразование, не должны завершаться ошибкой из-за неспособности создать отображение.

Смотри также

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

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