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

  • Статья

Возвращает входные прямоугольники, которые должны быть предоставлены вызывающим объектом для создания заданного выходного прямоугольника.

Синтаксис

HRESULT GetEffectRequiredInputRectangles(
  [in]           ID2D1Effect                         *renderEffect,
  [in, optional] const D2D1_RECT_F                   *renderImageRectangle,
  [in]           const D2D1_EFFECT_INPUT_DESCRIPTION *inputDescriptions,
  [out]          D2D1_RECT_F                         *requiredInputRects,
                 UINT32                              inputCount
);

Параметры

[in] renderEffect

Тип: ID2D1Effect*

Изображение, выходные данные которого отрисовываются.

[in, optional] renderImageRectangle

Тип: const D2D1_RECT_F*

Часть выходного изображения, входные данные которой проверяются.

[in] inputDescriptions

Тип: const D2D1_EFFECT_INPUT_DESCRIPTION*

Список входных данных, прямоугольники которых запрашиваются.

[out] requiredInputRects

Тип: D2D1_RECT_F*

Входные прямоугольники, возвращенные вызывающей объекту.

inputCount

Тип: UINT32

Количество входных данных.

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

Тип: HRESULT

Код сбоя, обычно это будет только потому, что эффект в цепочке вернул некоторую ошибку.

Комментарии

Вызывающий объект должен быть очень осторожным, чтобы не полагаться на требуемые возвращаемые входные прямоугольники. Небольшие изменения для правильности поведения эффекта могут привести к возврату различных прямоугольников. Кроме того, различные виды оптимизации, применяемые внутри отрисовки, также могут влиять на результат.

Требования

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

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

ID2D1DeviceContext