METODE IDCompositionVirtualSurface::Trim (dcomp.h)
Membuang piksel yang berada di luar persegi panjang pemangkasan yang ditentukan.
Sintaks
HRESULT Trim(
[in, optional] const RECT *rectangles,
[in] UINT count
);
Parameter
[in, optional] rectangles
Jenis: const RECT*
Array persegi panjang untuk disimpan.
[in] count
Jenis: UINT
Jumlah persegi panjang dalam array persegi panjang .
Nilai kembali
Jenis: HRESULT
Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.
Keterangan
Permukaan virtual mungkin tidak memiliki penyimpanan yang cukup untuk setiap piksel di permukaan. Aplikasi menginstruksikan mesin komposisi untuk mengalokasikan memori untuk permukaan dengan memanggil metode IDCompositionSurface::BeginDraw , dan untuk melepaskan memori untuk permukaan dengan memanggil metode IDCompositionVirtualSurface::Trim . Array persegi panjang mewakili wilayah permukaan virtual yang harus tetap dialokasikan setelah metode ini kembali. Piksel apa pun yang berada di luar set persegi panjang yang ditentukan tidak lagi digunakan untuk tekstur, dan memorinya dapat diklaim kembali.
Jika parameter hitungan nol, tidak ada piksel yang disimpan, dan semua memori yang dialokasikan untuk permukaan virtual dapat diklaim kembali. Parameter persegi panjang dapat berupa NULL hanya jika parameter hitungan adalah nol.
Metode ini gagal jika IDCompositionSurface::BeginDraw dipanggil untuk bitmap ini tanpa panggilan yang sesuai ke IDCompositionSurface::EndDraw.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | dcomp.h |
| Pustaka | Dcomp.lib |
| DLL | Dcomp.dll |