Метод ID2D1DeviceContext::CreateColorContextFromFilename (d2d1_1.h)
Создает контекст цвета, загружая его из указанного имени файла. Байты профиля — это содержимое файла, указанного в параметре Имя файла.
Синтаксис
HRESULT CreateColorContextFromFilename(
PCWSTR filename,
[out] ID2D1ColorContext **colorContext
);
Параметры
filename
Тип: PCWSTR
Путь к файлу с байтами профиля для инициализации контекста цвета.
[out] colorContext
Тип: ID2D1ColorContext**
При возврате этого метода содержит адрес указателя на новый контекст цвета.
Возвращаемое значение
Тип: HRESULT
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| HRESULT | Описание: |
|---|---|
| S_OK | Без ошибок. |
| E_OUTOFMEMORY | Direct2D не удалось выделить достаточно памяти для завершения вызова. |
| E_INVALIDARG | В метод передано недопустимое значение. |
Комментарии
Новый контекст цвета можно использовать в D2D1_BITMAP_PROPERTIES1 для инициализации цветового контекста созданного растрового изображения. Поле модели заголовка профиля проверяется, чтобы определить, является ли этот профиль sRGB или scRGB, а цветовое пространство обновляется соответственно. В противном случае пространство является пользовательским.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d2d1_1.h |
| DLL | D2d1.dll |