ID2D1DeviceContext::InvalidateEffectInputRectangle 方法 (d2d1_1.h)

这表示效果输入的一部分无效。 此方法可以多次调用。

可以使用此方法通过效果图传播无效矩形。 可以使用 GetEffectInvalidRectangles 方法查询 Direct2D。

注意 Direct2D 不会自动使用这些无效矩形来缩小所呈现效果的区域。
 
还可以使用此方法使呈现效果(D2D1_PROPERTY_CACHED 属性设置为 true 时累积的缓存失效。

语法

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

参数

[in] effect

类型: ID2D1Effect*

要失效的效果。

input

类型: UINT32

输入索引。

[in] inputRectangle

类型: const D2D1_RECT_F*

要失效的 rect。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 向返回函数传递了无效参数。

要求

要求
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1_1.h
DLL D2d1.dll

另请参阅

ID2D1DeviceContext