Метод ID2D1EffectContext::CreateColorContext (d2d1effectauthor.h)

Статья
08/22/2023

Создает контекст цвета из цветового пространства.

Если цветовое пространство имеет значение Custom, контекст инициализируется из параметров profile и profileSize .

Если цветовое пространство не является пользовательским, контекст инициализируется с помощью байтов профиля, связанных с цветовой областью. Параметры profile и profileSize игнорируются.

Синтаксис

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	В метод передано недопустимое значение.

Требования

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

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

ID2D1EffectContext

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