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

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

  • Статья

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

Синтаксис

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

Параметры

[in] effect

Тип: ID2D1Effect*

Эффект для получения недопустимых прямоугольников.

[out] rectangles

Тип: D2D1_RECT_F*

Массив структур D2D1_RECT_F . Его необходимо выделить для правильного размера. Количество недопустимых прямоугольников можно получить с помощью метода GetEffectInvalidRectangleCount .

[in] rectanglesCount

Тип: UINT32

Количество прямоугольников, которые необходимо получить.

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

Тип: HRESULT

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

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

Комментарии

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

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

Если запрашивается несколько недопустимых прямоугольников, прямоугольники, возвращаемые этим методом, могут перекрываться. В этом случае число прямоугольников может быть меньше, чем счетчик GetEffectInvalidRectangleCount.

Требования

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

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

ID2D1DeviceContext