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

此方法将图像源缓存的填充区域剪裁为仅指定矩形。

语法

HRESULT TrimCache(
  [in, optional] const D2D1_RECT_U *rectangleToPreserve
);

[in, optional] rectangleToPreserve

类型： const D2D1_RECT_U*

指定图像的区域（以像素为单位），应在图像源缓存中保留。矩形外部的区域将从缓存中逐出。默认情况下，这是一个空矩形，这意味着整个图像将从缓存中逐出。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

必须构造所提供的区域，以包含将绘制图像源时所在的比例。这些坐标必须以本地坐标提供。
这意味着，在调用 API 之前，必须根据 DPI 和其他相关转换（可能包括世界转换和画笔转换）对其进行调整。

如果在创建映像源时未请求按需缓存，此方法将失败。

与 ID2D1Device：：ClearResources 一样，调用方可能需要随后发出 D3D 刷新，然后才能减少内存使用量。

仅当已使用 D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND 选项初始化映像源时，才支持此操作。