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

确保已填充图像源缓存的指定区域。此方法可用于通过执行成本高昂的工作来填充呈现循环外部的缓存来最大程度地减少故障。此方法还可用于在绘制例程需要图像数据之前以推理方式加载图像数据。

语法

HRESULT EnsureCached(
  [ref] const D2D1_RECT_U & rectangleToFill
);

[ref] rectangleToFill

类型： const D2D1_RECT_U

指定应在缓存中填充的图像区域（以像素为单位）。默认情况下，这是图像的整个范围。

类型： HRESULT

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

如果尚未缓存该数据，则此 API 会将图像数据加载到图像源的缓存中。它不会剪裁预先存在的缓存（如果有）。
缓存中的填充区域比实际请求的要多。

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

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