Gets the invalid rectangles that have accumulated since the last time the effect was drawn and EndDraw was then called on the device context.
HRESULT GetEffectInvalidRectangles( [in] ID2D1Effect *effect, [out, size_is(rectanglesCount)] D2D1_RECT_F *, [in] UINT32 rectanglesCount );
- effect [in]
The effect to get the invalid rectangles from.
- rectanglesCount [in]
The number of rectangles to get.
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
|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.|
Note Direct2D does not automatically use these invalid rectangles to reduce the region of an effect that is rendered.
You can use the InvalidateEffectInputRectangle method to specify invalidated rectangles for Direct2D to propagate through an effect graph.
If multiple invalid rectangles are requested, the rectangles that this method returns may overlap. When this is the case, the rectangle count might be lower than the count that GetEffectInvalidRectangleCount.
Minimum supported client
|Windows 8 and Platform Update for Windows 7 [desktop apps only]|
Minimum supported server
|Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps only]|
Build date: 11/29/2012