Функция GetStandardColorSpaceProfileA (icm.h)
Извлекает профиль цвета, зарегистрированный для указанного стандартного цветового пространства.
Синтаксис
BOOL GetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwSCS,
PSTR pBuffer,
PDWORD pcbSize
);
Параметры
pMachineName
Зарезервировано. Должно иметь значение NULL. Этот параметр предназначен для указания имени компьютера, на котором требуется получить стандартный профиль цветового пространства. Указатель NULL указывает на локальный компьютер.
dwSCS
Задает значение идентификатора стандартного цветового пространства, для которого извлекается профиль. Единственными допустимыми значениями для этого параметра являются LCS_sRGB и LCS_WINDOWS_COLOR_SPACE.
pBuffer
Указатель на буфер, в котором должно быть помещено имя профиля. Если значение РАВНО NULL, вызов возвращает значение TRUE , а требуемый размер буфера помещается в pdwSize.
pcbSize
Указатель на переменную, содержащую размер буфера в байтах, на который указывает pProfileName. При возврате переменная содержит размер буфера, который фактически используется или требуется.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.
Комментарии
Если буфер, на который указывает pProfileName , должен быть динамически выделен приложением, приложение может вызвать функцию GetStandardColorSpaceProfile , чтобы получить размер, необходимый для буфера. Если метод GetStandardColorSpaceProfile вызывается с параметром pProfileName со значением NULL, он возвращает значение FALSE , а DWORD , на который указывает pdwSize , будет содержать количество байтов, необходимых для буфера, на который указывает pProfileName. Затем приложение может выделить буфер и снова вызвать Метод GetStandardColorSpaceProfile , указав для параметра pProfileName адрес буфера.
Эта функция поддерживает профили модели устройств Windows Color System (WCS) в дополнение к профилям Международного консорциума цветов (ICC). Он не поддерживает профили WCS CAMP или GMMP и возвращает ошибку, если такие профили используются.
Общие сведения о конкретных функциональных возможностях Windows Vista
В дополнение к профилям ICC будут поддерживаться dmp WCS. Он не будет поддерживать профили WCS CAMP или GMMP и возвращает ошибку, если такие профили используются с этим API.
Поддержка для отдельных пользователей и LUA
При этом будет получен профиль цвета, зарегистрированный для заданного стандартного цветового пространства для текущего пользователя. Если такой параметр отсутствует для текущего пользователя, он получает параметр уровня системы.
Для этого используется WcsGetDefaultColorProfile с WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Это исполняемый файл в контексте LUA.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |