允許轉換指出其輸出上要求的矩形如何對應至其輸入上的一組範例矩形。
語法
HRESULT MapOutputRectToInputRects(
const D2D1_RECT_L *outputRect,
[out] D2D1_RECT_L *inputRects,
UINT32 inputRectsCount
);
參數
outputRect
類型：const D2D1_RECT_L*
輸入必須從中對應的輸出矩形。
[out] inputRects
類型：D2D1_RECT_L*
對應的輸入集。 輸入將直接對應至轉換輸入。
inputRectsCount
類型：UINT32
指定的輸入數目。 Direct2D 保證這等於轉換上指定的輸入數目。
傳回值
類型：HRESULT
如果方法成功，則會傳回 S_OK。 如果失敗，它會傳回 HRESULT 錯誤碼。
言論
轉換實作必須確保它提供的任何圖元著色器或軟體回呼實作都接受這項計算。
轉換實作必須將此方法視為純粹的功能。 它可以根據封裝效果屬性所指定的目前狀態，根據對應的輸入和輸出矩形做為基底。 不過，它不得變更自己的狀態，以回應叫用此方法。 Direct2D 轉譯器實作會保留隨時以任何順序呼叫此方法的權利。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | d2d1effectauthor.h |
| 連結庫 | D2d1.lib |