共用方式為

ID2D1DeviceContext：：InvalidateEffectInputRectangle 方法 (d2d1_1.h)

  • 發行項

這表示效果的輸入部分無效。 這個方法可以多次呼叫。

您可以使用這個方法，透過效果圖形傳播無效的矩形。 您可以使用 GetEffectInvalidRectangles 方法來查詢 Direct2D。

注意 Direct2D 不會自動使用這些無效的矩形來減少呈現的效果區域。
 
您也可以使用這個方法使呈現效果 D2D1_PROPERTY_CACHED屬性設定 為 true 時累積的快取失效。

語法

HRESULT InvalidateEffectInputRectangle(
  [in] ID2D1Effect       *effect,
       UINT32            input,
  [in] const D2D1_RECT_F *inputRectangle
);

參數

[in] effect

類型： ID2D1Effect*

要失效的效果。

input

類型： UINT32

輸入索引。

[in] inputRectangle

類型： const D2D1_RECT_F*

要失效的 rect。

傳回值

類型： HRESULT

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

HRESULT 描述
S_OK 未發生任何錯誤。
E_OUTOFMEMORY Direct2D 無法配置足夠的記憶體來完成呼叫。
E_INVALIDARG 無效的參數已傳遞至傳回函式。

規格需求

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

另請參閱

ID2D1DeviceContext