ID2D1DeviceContext::InvalidateEffectInputRectangle method (d2d1_1.h)
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.
Syntax
HRESULT InvalidateEffectInputRectangle(
[in] ID2D1Effect *effect,
UINT32 input,
[in] const D2D1_RECT_F *inputRectangle
);
Parameters
[in] effect
Type: ID2D1Effect*
The effect to invalidate.
input
Type: UINT32
The input index.
[in] inputRectangle
Type: const D2D1_RECT_F*
The rect to invalidate.
Return value
Type: HRESULT
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. |
Requirements
Requirement | Value |
---|---|
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 |