Método ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&) (d2d1_3.h)
Esse método corta as regiões preenchidas do cache de origem da imagem apenas para o retângulo especificado.
Sintaxe
HRESULT TrimCache(
[ref] const D2D1_RECT_U & rectangleToPreserve
);
Parâmetros
[ref] rectangleToPreserve
Tipo: const D2D1_RECT_U
Especifica a região da imagem, em pixels, que deve ser preservada no cache de origem da imagem. As regiões que estão fora do retângulo são removidas do cache. Por padrão, esse é um retângulo vazio, o que significa que toda a imagem é removida do cache.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
A região fornecida deve ser construída para incluir a escala na qual a origem da imagem será desenhada. Essas coordenadas devem ser fornecidas em coordenadas locais.
Isso significa que eles devem ser ajustados antes de chamar a API de acordo com a DPI e outras transformações relevantes, que podem incluir as transformações de transformação e pincel do mundo.
Esse método falhará se o cache sob demanda não tiver sido solicitado quando a origem da imagem foi criada.
Assim como acontece com ID2D1Device::ClearResources, o chamador pode precisar emitir posteriormente uma liberação D3D antes que o uso da memória seja reduzido.
Essa operação só tem suporte quando a origem da imagem é inicializada usando a opção D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | d2d1_3.h |
| Biblioteca | D2d1_3.lib |
| DLL | D2d1_3.dll |