ID2D1Transform::MapInvalidRect method (d2d1effectauthor.h)

Sets the input rectangles for this rendering pass into the transform.

Syntax

HRESULT MapInvalidRect(
        UINT32      inputIndex,
        D2D1_RECT_L invalidInputRect,
  [out] D2D1_RECT_L *invalidOutputRect
);

Parameters

inputIndex

Type: UINT32

The index of the input rectangle.

invalidInputRect

Type: D2D1_RECT_L

The invalid input rectangle.

[out] invalidOutputRect

Type: D2D1_RECT_L*

The output rectangle to which the input rectangle must be mapped.

Return value

Type: HRESULT

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

The transform implementation must regard MapInvalidRect as purely functional. The transform implementation can base the mapped input rectangle on the transform implementation's current state as specified by the encapsulating effect properties. But the transform implementation can't change its own state in response to a call to MapInvalidRect. Direct2D can call this method at any time and in any sequence following a call to the MapInputRectsToOutputRect method.

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 d2d1effectauthor.h
Library D2d1.lib

See also

ID2D1EffectImpl

ID2D1Transform