ID2D1DeviceContext：：GetEffectInvalidRectangles 方法 (d2d1_1.h)

  • 發行項

取得自上次繪製效果后累積的無效矩形，然後在裝置內容上呼叫 EndDraw 。

語法

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

參數

[in] effect

類型： ID2D1Effect*

要從中取得無效矩形的效果。

[out] rectangles

類型： D2D1_RECT_F*

D2D1_RECT_F 結構的陣列。 您必須將此配置給正確的大小。 您可以使用 GetEffectInvalidRectangleCount 方法取得無效矩形的計數。

[in] rectanglesCount

類型： UINT32

要取得的矩形數目。

傳回值

類型： HRESULT

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

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

備註

注意 Direct2D 不會自動使用這些無效的矩形，以減少呈現的效果區域。
 

您可以使用 InvalidateEffectInputRectangle 方法來指定 Direct2D 的無效矩形，以透過效果圖傳播。

如果要求多個無效的矩形，這個方法傳回的矩形可能會重疊。 在此情況下，矩形計數可能會低於 GetEffectInvalidRectangleCount 的計數。

規格需求

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

另請參閱

ID2D1DeviceContext