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

另请参阅

ID2D1DeviceContext