ID2D1ImageSourceFromWic::EnsureCached(constD2D1_RECT_U&)-Methode (d2d1_3.h)
Stellt sicher, dass eine angegebene Region des Imagequellcaches aufgefüllt wird. Diese Methode kann verwendet werden, um Störungen zu minimieren, indem teure Arbeit ausgeführt wird, um Caches außerhalb einer Renderingschleife aufzufüllen. Diese Methode kann auch verwendet werden, um Bilddaten spekulativ zu laden, bevor sie von Zeichnungsroutinen benötigt werden.
Syntax
HRESULT EnsureCached(
[ref] const D2D1_RECT_U & rectangleToFill
);
Parameter
[ref] rectangleToFill
Typ: const D2D1_RECT_U
Gibt den Bereich des Bilds in Pixeln an, der im Cache aufgefüllt werden soll. Standardmäßig ist dies der gesamte Umfang des Bilds.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese API lädt Bilddaten in Caches von Bildquellen, wenn diese Daten noch nicht zwischengespeichert wurden. Vorhandene Caches werden ggf. nicht kürzungen.
Es können mehr Bereiche innerhalb des Caches aufgefüllt werden, als tatsächlich angefordert.
Der bereitgestellte Bereich muss so erstellt werden, dass er die Skalierung enthält, mit der die Bildquelle anschließend gezeichnet wird.
Diese Koordinaten müssen in lokalen Koordinaten angegeben werden.
Dies bedeutet, dass sie vor dem Aufrufen der API entsprechend dem DPI und anderen relevanten Transformationen angepasst werden müssen, zu denen die Welttransformationen und Pinseltransformationen gehören können.
Dieser Vorgang wird nur unterstützt, wenn die Bildquelle mit der Option D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND initialisiert wurde.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d2d1_3.h |
| Bibliothek | D2d1_3.lib |
| DLL | D2d1_3.dll |