ID2D1Transform::MapInvalidRect method

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
) const;

Parameters

inputIndex

Type: UINT32

The index of the input rectangle.

invalidInputRect

Type: D2D1_RECT_L

The invalid input rectangle.

invalidOutputRect [out]

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

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2d1effectauthor.h

Library

D2d1.lib

See also

ID2D1Transform
ID2D1EffectImpl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft