MÉTHODE ID2D1ImageSourceFromWic ::TrimCache(constD2D1_RECT_U&) (d2d1_3.h)

Cette méthode réduit les régions remplies du cache source d’image au rectangle spécifié.

Syntaxe

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

Paramètres

[ref] rectangleToPreserve

Type : const D2D1_RECT_U

Spécifie la région de l’image, en pixels, qui doit être conservée dans le cache source de l’image. Les régions qui se trouvent en dehors du rectangle sont supprimées du cache. Par défaut, il s’agit d’un rectangle vide, ce qui signifie que l’image entière est supprimée du cache.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La région fournie doit être construite pour inclure l’échelle à laquelle la source d’image sera dessinée. Ces coordonnées doivent être fournies en coordonnées locales.
Cela signifie qu’ils doivent être ajustés avant d’appeler l’API en fonction de l’PPP et d’autres transformations pertinentes, qui peuvent inclure la transformation mondiale et les transformations de pinceau.

Cette méthode échoue si la mise en cache à la demande n’a pas été demandée lors de la création de la source de l’image.

Comme avec ID2D1Device ::ClearResources, l’appelant peut avoir besoin d’émettre un vidage D3D avant de réduire l’utilisation de la mémoire.

Cette opération n’est prise en charge que lorsque la source d’image a été initialisée à l’aide de l’option D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.

Configuration requise

Plateforme cible	Windows
En-tête	d2d1_3.h
Bibliothèque	D2d1_3.lib
DLL	D2d1_3.dll

Voir aussi

ID2D1ImageSourceFromWic