METODE ID2D1ImageSourceFromWic::EnsureCached(constD2D1_RECT_U&) (d2d1_3.h)
Memastikan bahwa wilayah tertentu dari cache sumber gambar diisi. Metode ini dapat digunakan untuk meminimalkan gangguan dengan melakukan pekerjaan mahal untuk mengisi cache di luar perulangan penyajian. Metode ini juga dapat digunakan untuk memuat data gambar secara spekulatif sebelum diperlukan dengan menggambar rutinitas.
Sintaks
HRESULT EnsureCached(
[ref] const D2D1_RECT_U & rectangleToFill
);
Parameter
[ref] rectangleToFill
Jenis: const D2D1_RECT_U
Menentukan wilayah gambar, dalam piksel, yang harus diisi dalam cache. Secara default, ini adalah seluruh jangkauan gambar.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
API ini memuat data gambar ke dalam cache sumber gambar, jika data tersebut belum di-cache. Ini tidak memangkas cache yang sudah ada sebelumnya, jika ada.
Lebih banyak area dalam cache dapat diisi daripada yang sebenarnya diminta.
Wilayah yang disediakan harus dibangun untuk menyertakan skala yang kemudian akan digambar oleh sumber gambar.
Koordinat ini harus disediakan dalam koordinat lokal.
Ini berarti bahwa mereka harus disesuaikan sebelum memanggil API sesuai dengan DPI dan transformasi relevan lainnya, yang dapat mencakup transformasi dunia dan transformasi kuas.
Operasi ini hanya didukung ketika sumber gambar telah diinisialisasi menggunakan opsi D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.
Persyaratan
Target Platform | Windows |
Header | d2d1_3.h |
Pustaka | D2d1_3.lib |
DLL | D2d1_3.dll |