ID2D1DeviceContext::InvalidateEffectInputRectangle method

This indicates that a portion of an effect's input is invalid. This method can be called many times.

You can use this method to propagate invalid rectangles through an effect graph. You can query Direct2D using the GetEffectInvalidRectangles method.

Note  Direct2D does not automatically use these invalid rectangles to reduce the region of an effect that is rendered.
You can also use this method to invalidate caches that have accumulated while rendering effects that have the D2D1_PROPERTY_CACHED property set to true.


HRESULT InvalidateEffectInputRectangle(
  ID2D1Effect       *effect,
  UINT32            input,
  const D2D1_RECT_F *inputRectangle



Type: ID2D1Effect*

The effect to invalidate.


Type: UINT32

The input index.


Type: const D2D1_RECT_F*

The rect to invalidate.

Return Value


The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid parameter was passed to the returning function.


Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1_1.h
DLL D2d1.dll

See Also