Поделиться через


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

Извлекает структуру заголовков ICC из цветового профиля ICC или XML-профиля WCS. Драйверы и приложения должны предполагать, что значение TRUE указывает только на то, что возвращается правильно структурированный заголовок. Каждый тег по-прежнему необходимо проверять независимо с помощью устаревших API ICM2 или API схемы XML.

Синтаксис

BOOL GetColorProfileHeader(
  HPROFILE       hProfile,
  PPROFILEHEADER pHeader
);

Параметры

hProfile

Указывает дескриптор для соответствующего цветового профиля.

pHeader

Указывает на переменную, в которой должна быть размещена структура заголовков ICC.

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

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

Если эта функция завершается сбоем, возвращается значение FALSE. Эта функция завершится ошибкой— недопустимый ICC, или в параметре hProfile указана ссылка на XML-профиль WCS. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Чтобы определить, является ли заголовок производным от дескриптора профиля ICC или DMP, проверка подпись заголовка (байты заголовка 36–39). Если сигнатура имеет значение acsp (большой эндиан), то использовался профиль ICC. Если сигнатура имеет значение "cdmp" (big-endian), то использовался DMP.

Ниже перечислены отличительные признаки, определяющие заголовок как "синтезированный" для DMP WCS:

pIcmProfileHeader-phSignature> = 'pmdc' (little endian = big endian 'cdmp')

pIcmProfileHeader-phCMMType> = '1scw' (little endian = big endian 'wcs1').

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

См. также раздел