ID2D1ImageSourceFromWic：：TrimCache (constD2D1_RECT_U&) 方法 (d2d1_3.h)

這個方法會將影像來源快取的填入區域修剪為僅指定矩形。

語法

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

[ref] rectangleToPreserve

類型： const D2D1_RECT_U

指定影像的區域，以像素為單位，應該保留在影像來源快取中。矩形外部的區域會從快取收回。根據預設，這是空的矩形，表示從快取收回整個影像。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

必須建構提供的區域，以包含要繪製影像來源的縮放比例。這些座標必須以本機座標提供。
這表示必須在根據 DPI 和其他相關轉換呼叫 API 之前進行調整，其中包括世界轉換和筆刷轉換。

如果建立映像來源時未要求隨選快取，這個方法將會失敗。

如同 ID2D1Device：：ClearResources，呼叫端可能需要後續發出 D3D 排清，才能減少記憶體使用量。

只有在映射來源已使用 D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND 選項初始化時，才支援這項作業。