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(
  [in, optional] const D2D1_RECT_U *rectangleToFill
);

Parameter

[in, optional] rectangleToFill

Jenis: const D2D1_RECT_U*

Menentukan wilayah gambar, dalam piksel, yang harus diisi dalam cache. Secara default, ini adalah seluruh jangkauan gambar.

Mengembalikan nilai

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

Persyaratan	Nilai
Target Platform	Windows
Header	d2d1_3.h
Pustaka	D2d1_3.lib
DLL	D2d1_3.dll

Lihat juga

ID2D1ImageSourceFromWic