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 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1_1.h
DLL	D2d1.dll

另请参阅

ID2D1DeviceContext