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

Статья
02/24/2024

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

Этот метод можно использовать для распространения недопустимых прямоугольников через граф эффекта. Вы можете запросить Direct2D с помощью метода GetEffectInvalidRectangles .

Примечание Direct2D не использует эти недопустимые прямоугольники автоматически для уменьшения области отображаемого эффекта.

Этот метод также можно использовать для аннулирования кэшей, накопленных во время отрисовки эффектов, для которых свойство D2D1_PROPERTY_CACHED имеет значение true.

Синтаксис

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

Параметры

[in] effect

Тип: ID2D1Effect*

Эффект, который необходимо сделать недействительным.

input

Тип: UINT32

Входной индекс.

[in] inputRectangle

Тип: const D2D1_RECT_F*

Прямоугольник, который необходимо сделать недействительным.

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

Тип: 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	d2d1_1.h
DLL	D2d1.dll

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

ID2D1DeviceContext

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