Fungsi EngControlSprites (winddi.h)
Fungsi EngControlSprites melucuti atau menggambar ulang sprite pada area WNDOBJ yang ditentukan.
Sintaks
ENGAPI BOOL EngControlSprites(
WNDOBJ *pwo,
FLONG fl
);
Parameter
pwo
Penunjuk ke struktur WNDOBJ tempat sprite sedang dibangun atau ditumbangkan.
fl
Parameter ini bisa menjadi salah satu nilai berikut:
ECS_TEARDOWN
Meminta agar GDI merobek dan menghapus efek sprite dari sprite apa pun yang tumpang tindih dengan area WNDOBJ. Dengan kata lain, GDI menggambar ulang sprite dengan efek yang dinetralkan sehingga sprite tidak terlihat di layar. GDI memulihkan area di bawah sprite dengan melakukan panggilan langsung ke DrvCopyBits.
ECS_REDRAW
Meminta GDI menggambar ulang, memulihkan sprite apa pun yang tumpang tindih dengan area WNDOBJ. GDI menggambar ulang langsung ke layar dengan melakukan panggilan ke DrvCopyBits.
Nilai kembali
EngControlSprites mengembalikan TRUE setelah berhasil menyelesaikan operasi yang diminta; jika tidak, ia mengembalikan FALSE.
Keterangan
Pemanggilan ECS_TEARDOWN mungkin persisten. Misalnya, driver dapat memanggil EngControlSprites sekali dengan ECS_TEARDOWN segera setelah membuat WNDOBJ, dan tidak ada sprite yang akan pernah digambar di atas jendela.
Pengemudi dapat memanggil EngControlSprites dengan ECS_REDRAW berkali-kali tanpa melakukan panggilan intervensi dengan ECS_TEARDOWN untuk memaksa pengecatan ulang sprite kapan saja.
ECS_TEARDOWN selalu memaksa penggalian ulang segera dari sprite apa pun di atas area WNDOBJ. GDI menyimpan bit di bawah sprite dengan memanggil DrvCopyBits untuk menyalinnya dari layar, lalu menyusun sprite ke layar dengan memanggil DrvCopyBits. Ini dapat digunakan untuk memungkinkan sprite disusun ke back-buffer tepat sebelum perintah swap-buffer dikirim ke perangkat keras (melalui DrvSwapBuffers atau mekanisme buffer pertukaran driver lainnya). Ini memungkinkan penggabungan sprite yang mulus, tanpa berkedip, ketika jendela buffering ganda.
ECS_TEARDOWN tidak akan pernah menyebabkan pesan WOC_SPRITE_NO_OVERLAP dikirim, dan demikian juga ECS_REDRAW tidak akan pernah menyebabkan pesan WOC_SPRITE_OVERLAP dikirim.
EngControlSprites dapat dipanggil meskipun saat ini tidak ada sprite yang tumpang tindih dengan area WNDOBJ.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows. |
| Target Platform | Universal |
| Header | winddi.h (termasuk Winddi.h) |
| Pustaka | Win32k.lib |
| DLL | Win32k.sys |