Metode ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&) (d2d1_3.h)

Metode ini memangkas wilayah yang diisi dari cache sumber gambar hanya menjadi persegi panjang yang ditentukan.

Sintaks

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

Parameter

[ref] rectangleToPreserve

Jenis: const D2D1_RECT_U

Menentukan wilayah gambar, dalam piksel, yang harus dipertahankan dalam cache sumber gambar. Wilayah yang berada di luar persegi panjang dikeluarkan dari cache. Secara default, ini adalah persegi panjang kosong, yang berarti bahwa seluruh gambar dikeluarkan dari cache.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Wilayah yang disediakan harus dibangun untuk menyertakan skala tempat sumber gambar akan ditarik. 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.

Metode ini akan gagal jika penembolokan sesuai permintaan tidak diminta ketika sumber gambar dibuat.

Seperti halnya ID2D1Device::ClearResources, pemanggil kemudian perlu mengeluarkan flush D3D sebelum penggunaan memori berkurang.

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

Lihat juga

ID2D1ImageSourceFromWic