ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&)-Methode (d2d1_3.h)

  • Artikel

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

Weitere Informationen

ID2D1ImageSourceFromWic