Метод 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 |