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 错误代码。

注解

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

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

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

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

要求

   
目标平台 Windows
标头 d2d1_3.h
Library D2d1_3.lib
DLL D2d1_3.dll

另请参阅

ID2D1ImageSourceFromWic