Metodo ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U*) (d2d1_3.h)

Questo metodo taglia le aree popolate della cache dell'origine dell'immagine solo al rettangolo specificato.

Sintassi

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

Parametri

[in, optional] rectangleToPreserve

Tipo: const D2D1_RECT_U*

Specifica l'area dell'immagine, in pixel, che deve essere mantenuta nella cache di origine dell'immagine. Le aree esterne al rettangolo vengono rimosse dalla cache. Per impostazione predefinita, si tratta di un rettangolo vuoto, ovvero l'intera immagine viene rimossa dalla cache.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'area specificata deve essere costruita per includere la scala in cui verrà disegnata l'origine dell'immagine. Queste coordinate devono essere specificate nelle coordinate locali.
Ciò significa che devono essere regolati prima di chiamare l'API in base al DPI e ad altre trasformazioni pertinenti, che possono includere le trasformazioni del mondo e del pennello.

Questo metodo avrà esito negativo se la memorizzazione nella cache su richiesta non è stata richiesta quando è stata creata l'origine dell'immagine.

Come per ID2D1Device::ClearResources, il chiamante può dover eseguire successivamente uno scaricamento D3D prima che l'utilizzo della memoria venga ridotto.

Questa operazione è supportata solo quando l'origine dell'immagine è stata inizializzata usando l'opzione D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.

Requisiti

Vedi anche

ID2D1ImageSourceFromWic