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

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

  • Статья

Используя дескриптор открытого цветового профиля, функция GetColorProfileFromHandle копирует содержимое профиля в буфер, предоставленный приложением. Если дескриптор является дескриптором системы цвета Windows (WCS), возвращается DMP, а связанные с HPROFILE файлы CAMP и GMMP игнорируются.

Синтаксис

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

Параметры

hProfile

Дескриптор открытого цветового профиля. Функция определяет, содержит ли HPROFILE сведения о профиле ICC или WCS.

pProfile

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

pcbProfile

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

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

Если эта функция завершается успешно, возвращается значение TRUE. Он возвращает значение FALSE , если параметр pBuffer имеет значение NULL и размер, необходимый для буфера, копируется в pcbSize.

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

Требования

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

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