Partager via


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

Voir aussi

ID2D1ImageSourceFromWic