Метод ID2D1DeviceContext::CreateColorContext (d2d1_1.h)

Статья
08/22/2023

Создает контекст цвета.

Синтаксис

HRESULT CreateColorContext(
                 D2D1_COLOR_SPACE  space,
  [in, optional] const BYTE        *profile,
                 UINT32            profileSize,
  [out]          ID2D1ColorContext **colorContext
);

Параметры

space

Тип: D2D1_COLOR_SPACE

Пространство создаваемого контекста цвета.

[in, optional] profile

Тип: const BYTE*

Буфер, содержащий байты профиля ICC, используемые для инициализации контекста цвета, когда пространствоD2D1_COLOR_SPACE_CUSTOM. Для других типов параметр игнорируется и должен иметь значение NULL.

profileSize

Тип: UINT32

Размер профиля в байтах.

[out] colorContext

Тип: ID2D1ColorContext**

При возврате этим методом содержит адрес указателя на новый объект контекста цвета.

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

Тип: HRESULT

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

HRESULT	Описание:
S_OK	Без ошибок.
E_OUTOFMEMORY	Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG	В метод было передано недопустимое значение.

Если пробелD2D1_COLOR_SPACE_CUSTOM, необходимо указать profile и profileSize . В противном случае для этих параметров следует задать значение NULL и ноль соответственно. Когда пространство D2D1_COLOR_SPACE_CUSTOM, проверяется поле модели заголовка профиля, чтобы определить, является ли этот профиль sRGB или scRGB, и цветовое пространство обновляется соответственно. В противном случае пространство остается пользовательским.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1_1.h
DLL	D2d1.dll

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

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext