ID2D1DeviceContext::GetEffectRequiredInputRectangles method (d2d1_1.h)
Returns the input rectangles that are required to be supplied by the caller to produce the given output rectangle.
Syntax
HRESULT GetEffectRequiredInputRectangles(
[in] ID2D1Effect *renderEffect,
[in, optional] const D2D1_RECT_F *renderImageRectangle,
[in] const D2D1_EFFECT_INPUT_DESCRIPTION *inputDescriptions,
[out] D2D1_RECT_F *requiredInputRects,
UINT32 inputCount
);
Parameters
[in] renderEffect
Type: ID2D1Effect*
The image whose output is being rendered.
[in, optional] renderImageRectangle
Type: const D2D1_RECT_F*
The portion of the output image whose inputs are being inspected.
[in] inputDescriptions
Type: const D2D1_EFFECT_INPUT_DESCRIPTION*
A list of the inputs whose rectangles are being queried.
[out] requiredInputRects
Type: D2D1_RECT_F*
The input rectangles returned to the caller.
inputCount
Type: UINT32
The number of inputs.
Return value
Type: HRESULT
A failure code, this will typically only be because an effect in the chain returned some error.
Remarks
The caller should be very careful not to place a reliance on the required input rectangles returned. Small changes for correctness to an effect's behavior can result in different rectangles being returned. In addition, different kinds of optimization applied inside the render can also influence the result.
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 |