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

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

Sintassi

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

Parametri

[ref] rectangleToPreserve

Tipo: const D2D1_RECT_U

Specifica l'area dell'immagine, in pixel, che deve essere mantenuta nella cache dell'origine immagine. Le aree esterne al rettangolo vengono rimosse dalla cache. Per impostazione predefinita, si tratta di un rettangolo vuoto, ovvero che 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à tracciata l'origine dell'immagine. Queste coordinate devono essere fornite nelle coordinate locali.
Ciò significa che devono essere regolati prima di chiamare l'API in base alla DPI e ad altre trasformazioni pertinenti, che possono includere la trasformazione mondiale e le trasformazioni 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ò successivamente rilasciare uno scaricamento D3D prima della riduzione dell'utilizzo della memoria.

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

Requisiti

Vedi anche

ID2D1ImageSourceFromWic