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

Weitere Informationen

ID2D1ImageSourceFromWic