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 |