Функция GetColorProfileFromHandle

Получив дескриптор открытого профиля цвета, функция GetColorProfileFromHandle скопирует содержание профиля в буфер, поставляемый приложением.

Синтаксис

BOOL WINAPI GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE pBuffer,
  PDWORD pcbSize
);

Параметры

hProfile

Дескриптор открытого профиля цвета.

pBuffer

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

pcbSize

Указатель на двойное слово (DWORD), которое содержит размер буфера указанный параметром pBuffer. По возвращению параметр заполняется размером буфера, который фактически использовался, если функция завершается успешно. Если эта функция будет вызвана с установленным параметром pBuffer в НУЛЬ (NULL), то этот параметр будет содержать в себе размер требуемого буфера.

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

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE). Она также возвращает значение ИСТИНА (TRUE), если параметр pBuffer - НУЛЬ (NULL), а размер, требуемый для буфера, копируется в pcbSize.

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

Смотри также

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

Размещение и совместимость GetColorProfileFromHandle

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Нет
е Windows Me Да
н Windows 98 Да
т Windows 95 Нет
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Нет
в    
е    
р    
Используемая библиотека Mscms.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Icm.h
 - включено в -
 Unicode Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz