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

Метод ID2D1Factory1::GetEffectProperties (d2d1_1.h)

  • Статья

Извлекает свойства эффекта.

Синтаксис

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Параметры

[in] effectId

Тип: REFCLSID

Идентификатор эффекта, из которого извлекаются свойства.

[out] properties

Тип: ID2D1Properties**

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

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

Тип: HRESULT

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

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

Комментарии

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

  • Типы значений будут заполнены нулевыми значениями.
  • Типы BLOB-объектов и строк будут иметь нулевую длину.
  • Типы массивов будут иметь длину 1, а элемент массива будет соответствовать предыдущим правилам.
Этот метод нельзя использовать для возврата свойств для любого эффекта, невидимого для ID2D1DeviceContext::CreateEffect.

Требования

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

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

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect