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

  • Статья

Создает эффект для указанного идентификатора класса.

Синтаксис

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

Параметры

effectId

Тип: REFCLSID

Идентификатор класса создаваемого эффекта. Список идентификаторов эффектов см. в разделе Встроенные эффекты .

[out] effect

Тип: ID2D1Effect**

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

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

Тип: HRESULT

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

HRESULT Описание:
S_OK Без ошибок.
E_OUTOFMEMORY Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG В метод было передано недопустимое значение.
D3DERR_OUTOFVIDEOMEMORY У Direct3D недостаточно памяти для выполнения операции.
D2DERR_EFFECT_IS_NOT_REGISTERED Указанный эффект не регистрируется системой.
E_NOTFOUND Другой возможный HRESULT для эффекта, не зарегистрированного (например, D2DERR_EFFECT_IS_NOT_REGISTERED).
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES Для эффекта требуются возможности, не поддерживаемые устройством D2D.

Комментарии

Если созданный эффект является пользовательским эффектом, реализованным в библиотеке DLL, это не увеличивает число ссылок для этой библиотеки DLL. Если приложение удаляет эффект во время загрузки этого эффекта, результирующее поведение будет непредсказуемым.

Требования

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

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

Эффекты

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect