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 會將影像數據載入影像來源的快取。如果有任何的話，它不會修剪既有的快取。
快取中的區域可以填入比實際要求更多的區域。

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

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