Метод ID2D1EffectContext::CreateEffect (d2d1effectauthor.h)
Создает эффект Direct2D для указанного идентификатора класса. Это то же самое, что и ID2D1DeviceContext::CreateEffect , поэтому пользовательские эффекты могут создавать другие эффекты и упаковывать их в преобразование.
Синтаксис
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 | Указанный эффект не зарегистрирован системой. |
Комментарии
Созданный эффект не ссылается на число библиотек DLL, из которых был создан эффект. Если вызывающий объект отменяет регистрацию эффекта во время загрузки этого эффекта, результирующее поведение будет непредсказуемым.
Требования
| Минимальная версия клиента | Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d2d1effectauthor.h |
| Библиотека | D2D1.lib |