Функция GetColorProfileElement

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

Синтаксис

Параметры

hProfile

Определяет дескриптор рассматриваемого профиля цвета.

tag

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

dwOffset

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

pcbSize

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

pBuffer

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

pbReference

Указывает на Булеву переменную, которая устанавливается в значение ИСТИНА (TRUE), если более чем один тег в профиле цвета ссылается на те же самые данные на которые ссылаются указанные теги, или ЛОЖЬ (FALSE), если этого нет.

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

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

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Для дополнительной информации об ошибке, вызовите GetLastError.

Замечания

Если указатель pBuffer устанавливается в НУЛЬ (NULL), размер всех теговых данных элемента в байтах возвращается в переменной, указанной при помощи параметра pcbSize, а параметр dwOffset игнорируется.

Смотри также

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