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

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

  • Статья

Копирует данные из указанного элемента профиля с тегами указанного цветового профиля в буфер.

Синтаксис

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

Параметры

hProfile

Указывает дескриптор соответствующего цветового профиля Международного консорциума цветов (ICC).

tag

Идентифицирует элемент с тегом, из которого выполняется копирование.

dwOffset

Задает смещение от первого байта помеченных данных элемента, с которого начинается копирование.

pcbElement

Указатель на переменную, указывающую количество байтов для копирования. При возврате переменная содержит количество фактически скопированных байтов.

pElement

Указатель на буфер, в который копируются данные элемента с тегами. Буфер должен содержать по крайней мере столько байтов, сколько указано переменной, на которую указывает pcbSize. Если для указателя pBuffer задано значение NULL, размер всех данных элемента с тегами в байтах возвращается в расположении памяти, на который указывает pcbSize, а dwOffset игнорируется. В этом случае функция возвращает значение FALSE.

pbReference

Указывает на логическое значение, которое имеет значение TRUE , если несколько тегов в цветовом профиле ссылаются на те же данные, на которые ссылается указанный тег, или FALSE , если нет.

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

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

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

Комментарии

Эта функция завершится ошибкой, если hProfile не является допустимым профилем Международного консорциума цветов (ICC).

Если для указателя pBuffer задано значение NULL, размер всех данных элемента с тегами в байтах возвращается в переменной, на которую указывает pcbSize, а dwOffset игнорируется.

Эта функция не поддерживает профили WINDOWS Color System (WCS) CAMP, DMP и GMMP; Поскольку элементы профиля неявно связаны с типами тегов ICC и жестко кодируются для них, и существует множество надежных библиотек синтаксического анализа XML.

Требования

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

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