Método ID2D1ImageSourceFromWic::EnsureCached(constD2D1_RECT_U*) (d2d1_3.h)
Garantiza que se rellena una región especificada de la memoria caché de origen de la imagen. Este método se puede usar para minimizar los problemas realizando un trabajo costoso para rellenar las memorias caché fuera de un bucle de representación. Este método también se puede usar para cargar datos de imagen especulativamente antes de que sea necesario mediante rutinas de dibujo.
Sintaxis
HRESULT EnsureCached(
[in, optional] const D2D1_RECT_U *rectangleToFill
);
Parámetros
[in, optional] rectangleToFill
Tipo: const D2D1_RECT_U*
Especifica la región de la imagen, en píxeles, que se debe rellenar en la memoria caché. De forma predeterminada, esta es la extensión completa de la imagen.
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
Esta API carga datos de imagen en cachés de orígenes de imágenes, si esos datos aún no se han almacenado en caché. No recorta las memorias caché preexistentes, si las hay.
Se pueden rellenar más áreas de la memoria caché de las solicitadas realmente.
La región proporcionada debe construirse para incluir la escala con la que se dibujará posteriormente 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.
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 |