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