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

Diese Methode schneidet die aufgefüllten Bereiche des Bildquellencaches auf das angegebene Rechteck ab.

Syntax

HRESULT TrimCache(
  [in, optional] const D2D1_RECT_U *rectangleToPreserve
);

Parameter

[in, optional] rectangleToPreserve

Typ: const D2D1_RECT_U*

Gibt den Bereich des Bilds in Pixel an, der im Bildquellencache beibehalten werden soll. Bereiche, die sich außerhalb des Rechtecks befinden, werden aus dem Cache entfernt. Standardmäßig ist dies ein leeres Rechteck, d. h. das gesamte Bild wird aus dem Cache entfernt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der bereitgestellte Bereich muss so konstruiert werden, dass er den Maßstab enthält, 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 dem DPI und anderen relevanten Transformationen angepasst werden müssen, zu denen die Welttransformationen und Pinseltransformationen gehören können.

Diese Methode schlägt fehl, wenn beim Erstellen der Imagequelle keine Bedarfszwischenspeicherung angefordert wurde.

Wie bei ID2D1Device::ClearResources kann der Aufrufer anschließend eine D3D-Leerung ausgeben müssen, bevor die Arbeitsspeicherauslastung reduziert wird.

Dieser Vorgang wird nur unterstützt, wenn die Bildquelle mit der Option D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND initialisiert wurde.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d2d1_3.h
Bibliothek	D2d1_3.lib
DLL	D2d1_3.dll

Weitere Informationen

ID2D1ImageSourceFromWic