ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&)-Methode (d2d1_3.h)
Diese Methode schneidet die aufgefüllten Regionen des Bildquellencaches auf das angegebene Rechteck ab.
Syntax
HRESULT TrimCache(
[ref] const D2D1_RECT_U & rectangleToPreserve
);
Parameter
[ref] rectangleToPreserve
Typ: const D2D1_RECT_U
Gibt den Bereich des Bilds in Pixel an, der im Quellcache des Bilds beibehalten werden soll. Regionen, die sich außerhalb des Rechtecks befinden, werden aus dem Cache entfernt. Standardmäßig ist dies ein leeres Rechteck, was bedeutet, dass das gesamte Bild aus dem Cache entfernt wird.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die bereitgestellte Region muss so erstellt werden, dass sie den Maßstab einschließt, in dem die Bildquelle gezeichnet wird. Diese Koordinaten müssen in lokalen Koordinaten angegeben werden.
Dies bedeutet, dass sie vor dem Aufrufen der API entsprechend den DPI- und anderen relevanten Transformationen angepasst werden müssen, die die Welttransformation und Pinseltransformationen umfassen können.
Diese Methode schlägt fehl, wenn die bedarfsgesteuerte Zwischenspeicherung beim Erstellen der Imagequelle nicht angefordert wurde.
Wie bei ID2D1Device::ClearResources muss der Aufrufer anschließend eine D3D-Leerung ausgeben, bevor die Arbeitsspeicherauslastung reduziert wird.
Dieser Vorgang wird nur unterstützt, wenn die Bildquelle mithilfe 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 |