ID2D1DeviceContext::GetEffectRequiredInputRectangles 方法 (d2d1_1.h)

傳回呼叫端必須提供的輸入矩形,以產生指定的輸出矩形。

語法

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

參數

[in] renderEffect

類型: ID2D1Effect*

正在轉譯其輸出的影像。

[in, optional] renderImageRectangle

類型: const D2D1_RECT_F*

正在檢查其輸入的輸出影像部分。

[in] inputDescriptions

類型: const D2D1_EFFECT_INPUT_DESCRIPTION*

正在查詢其矩形的輸入清單。

[out] requiredInputRects

類型: D2D1_RECT_F*

傳回給呼叫端的輸入矩形。

inputCount

類型: UINT32

輸入的數目。

傳回值

類型: HRESULT

失敗碼通常只會因為鏈結中的效果傳回一些錯誤。

備註

呼叫端應該非常小心,不要依賴傳回的必要輸入矩形。 對效果行為的正確性所做的小變更可能會導致傳回不同的矩形。 此外,轉譯內套用的不同優化類型也會影響結果。

規格需求

需求
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
Dll D2d1.dll

另請參閱

ID2D1DeviceContext