fungsi CLIPOBJ_cEnumStart (winddi.h)
Fungsi CLIPOBJ_cEnumStart mengatur parameter untuk menghitung persegi panjang di wilayah klip tertentu.
Sintaks
ENGAPI ULONG CLIPOBJ_cEnumStart(
[in] CLIPOBJ *pco,
[in] BOOL bAll,
[in] ULONG iType,
[in] ULONG iDirection,
[in] ULONG cLimit
);
Parameter
[in] pco
Arahkan ke struktur CLIPOBJ yang menentukan wilayah klip yang akan dijumlahkan.
[in] bAll
Menentukan apakah seluruh wilayah harus dijumlahkan. Parameter ini TRUE jika seluruh wilayah harus dijumlahkan. Ini FALSE jika hanya bagian yang relevan dengan operasi gambar saat ini yang harus dijumlahkan.
Driver yang menyimpan cache wilayah klip harus menghitung seluruh wilayah.
[in] iType
Menentukan struktur data yang akan ditulis oleh CLIPOBJ_bEnum. Parameter ini saat ini harus CT_RECTANGLES, menunjukkan bahwa wilayah tersebut akan dijumlahkan sebagai daftar persegi panjang.
[in] iDirection
Menentukan urutan di mana persegi panjang akan dijumlahkan. Urutan ini bisa sangat penting jika operasi DrvBitBlt dijalankan secara bersamaan pada permukaan yang sama. Jika pesanan tidak relevan dengan driver perangkat, CD_ANY harus ditentukan untuk wilayah yang kompleks, memungkinkan GDI untuk mengoptimalkan enumerasi. Nilai ini bisa menjadi salah satu dari berikut ini:
| Nilai | Makna |
|---|---|
| CD_ANY | Setiap pesanan yang nyaman untuk GDI. |
| CD_LEFTDOWN | Kanan ke kiri, atas ke bawah. |
| CD_LEFTUP | Kanan ke kiri, bawah ke atas. |
| CD_RIGHTDOWN | Kiri ke kanan, atas ke bawah. |
| CD_RIGHTUP | Kiri ke kanan, bawah ke atas. |
[in] cLimit
Menentukan jumlah maksimum persegi panjang yang akan dijumlahkan. Jika parameter ini nol, penghitungan akan dihilangkan.
Mengembalikan nilai
Nilai yang dikembalikan adalah hitungan persegi panjang yang dijumlahkan. Jika jumlah melebihi cLimit, nilai yang dikembalikan adalah 0xFFFFFFFF.
Keterangan
Wilayah dapat dijumlahkan apakah fungsi ini dipanggil. Secara default, driver hanya menghitung persegi panjang yang relevan, dimulai dari kiri atas.
Driver dapat memulai ulang enumerasi dengan memanggil fungsi ini lagi.
Persyaratan
| 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 |