MÉTHODE ID2D1ImageSourceFromWic ::EnsureCached(constD2D1_RECT_U&) (d2d1_3.h)
Garantit qu’une région spécifiée du cache source d’image est remplie. Cette méthode peut être utilisée pour réduire les problèmes en effectuant un travail coûteux pour remplir les caches en dehors d’une boucle de rendu. Cette méthode peut également être utilisée pour charger de manière spéculative des données d’image avant que les routines de dessin n’en ont besoin.
Syntaxe
HRESULT EnsureCached(
[ref] const D2D1_RECT_U & rectangleToFill
);
Paramètres
[ref] rectangleToFill
Type : const D2D1_RECT_U
Spécifie la région de l’image, en pixels, qui doit être remplie dans le cache. Par défaut, il s’agit de l’intégralité de l’étendue de l’image.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette API charge les données d’image dans les caches des sources d’images, si ces données n’ont pas déjà été mises en cache. Il ne supprime pas les caches préexistants, le cas échéant.
Plus de zones dans le cache peuvent être remplies que demandées.
La région fournie doit être construite pour inclure l’échelle avec laquelle la source d’image sera ensuite 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 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 |