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 |