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 |