Метод 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.

Требования

См. также раздел

ID2D1ImageSourceFromWic