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

Assicura che venga popolata un'area specificata della cache di origine dell'immagine. Questo metodo può essere usato per ridurre al minimo glitch eseguendo operazioni dispendiose per popolare le cache all'esterno di un ciclo di rendering. Questo metodo può essere usato anche per caricare speculativamente i dati dell'immagine prima che siano necessari tramite routine di disegno.

Sintassi

HRESULT EnsureCached(
  [ref] const D2D1_RECT_U & rectangleToFill
);

Parametri

[ref] rectangleToFill

Tipo: const D2D1_RECT_U

Specifica l'area dell'immagine, in pixel, che deve essere popolata nella cache. Per impostazione predefinita, si tratta dell'intera estensione dell'immagine.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa API carica i dati dell'immagine nella cache delle origini immagini, se tali dati non sono già stati memorizzati nella cache. Non taglia le cache preesistenti, se presenti.
È possibile popolare più aree all'interno della cache rispetto a quelle effettivamente richieste.

L'area specificata deve essere costruita per includere la scala con 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.

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

Requisiti

Piattaforma di destinazione	Windows
Intestazione	d2d1_3.h
Libreria	D2d1_3.lib
DLL	D2d1_3.dll

Vedi anche

ID2D1ImageSourceFromWic