Функция GetStandardColorSpaceProfile

Функция GetStandardColorSpaceProfile извлекает профиль цвета, зарегистрированный для указанного стандартного цветового пространства (color space).

Синтаксис

Параметры

pMachineName

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

dwProfileID

Определяет значение идентификатора (ID) стандартного цветового пространства, для которого извлекается профиль.

pProfileName

Указатель в буфер в котором должно расположиться имя профиля. Если параметр - НУЛЬ (NULL), вызов возвратит ИСТИНА (TRUE), а необходимый размер буфера разместится в параметре  pdwSize.

pdwSize

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

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

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE).

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

Замечания

Если бы буфер указывался при помощи параметра pProfileName, то он должен бы быть динамически назначен приложением, которое может вызвать функцию GetStandardColorSpaceProfile, чтобы извлечь размер, требуемый для буфера. Если GetStandardColorSpaceProfile будут вызывать с pProfileName установленным в НУЛЬ (NULL), то функция возвратит ЛОЖЬ (FALSE), а ДВОЙНОЕ СЛОВО (DWORD), на которое указывает параметр pdwSize будет содержать в себе число байтов, необходимых для буфера, на который указывает параметр pProfileName. Приложение может затем назначить буфер и запросить GetStandardColorSpaceProfile снова при помощи pProfileName с установленным адресом буфера.

Смотри также

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