Método ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U*) (d2d1_3.h)
Este método recorta las regiones rellenadas de la memoria caché de origen de la imagen solo en el rectángulo especificado.
Sintaxis
HRESULT TrimCache(
[in, optional] const D2D1_RECT_U *rectangleToPreserve
);
Parámetros
[in, optional] rectangleToPreserve
Tipo: const D2D1_RECT_U*
Especifica la región de la imagen, en píxeles, que se debe conservar en la caché de origen de la imagen. Las regiones que están fuera del rectángulo se expulsan de la memoria caché. De forma predeterminada, se trata de un rectángulo vacío, lo que significa que toda la imagen se expulsa de la memoria caché.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
La región proporcionada debe construirse para incluir la escala en la que se dibujará el origen de la imagen. Estas coordenadas deben proporcionarse en coordenadas locales.
Esto significa que deben ajustarse antes de llamar a la API según el PPP y otras transformaciones pertinentes, que pueden incluir la transformación del mundo y las transformaciones de pincel.
Este método producirá un error si no se solicitó el almacenamiento en caché a petición cuando se creó el origen de la imagen.
Al igual que con ID2D1Device::ClearResources, el autor de la llamada puede necesitar posteriormente emitir un vaciado D3D antes de reducir el uso de memoria.
Esta operación solo se admite cuando el origen de la imagen se ha inicializado mediante la opción D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d2d1_3.h |
| Library | D2d1_3.lib |
| Archivo DLL | D2d1_3.dll |