WNDOBJ_cEnumStart (winddi.h)

Artikel
03/15/2023

Fungsi WNDOBJ_cEnumStart adalah fungsi panggilan balik yang mengatur parameter untuk enumerasi persegi panjang di wilayah jendela yang terlihat.

Sintaks

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Parameter

pwo

Penunjuk ke struktur WNDOBJ yang dibuat oleh panggilan ke EngCreateWnd.

iType

Menentukan jenis struktur yang akan dikembalikan oleh WNDOBJ_bEnum. Parameter ini dapat CT_RECTANGLES, yang berarti bahwa wilayah tersebut akan dijumlahkan sebagai daftar persegi panjang.

iDirection

Menentukan urutan pengembalian persegi panjang. Urutan ini bisa sangat penting ketika DrvBitBlt yang tumpang tindih sedang dilakukan pada permukaan yang sama. Jika pesanan tidak relevan dengan driver perangkat, maka CD_ANY harus ditentukan. Hal ini memungkinkan GDI untuk mengoptimalkan enumerasinya untuk wilayah yang kompleks. Parameter ini bisa menjadi salah satu nilai berikut:

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_LEFTWARDS	Kiri ke kanan, arah vertikal tidak didefinisikan.
CD_RIGHTDOWN	Kiri ke kanan, atas ke bawah.
CD_RIGHTUP	Kiri ke kanan, bawah ke atas.
CD_UPWARDS	Bawah ke atas, arah horizontal tidak ditentukan.

cLimit

Adalah indikasi berapa banyak objek yang diminati driver dalam penembolokan. Ini hanya digunakan untuk memutuskan kapan berhenti menghitung persegi panjang saat GDI menghitung nilai pengembalian untuk fungsi ini. Jika cLimit adalah nol, penghitungan tidak dilakukan.

Mengembalikan nilai

Nilai yang dikembalikan adalah hitungan jumlah objek yang akan dijumlahkan, asalkan nilai ini kurang dari atau sama dengan cLimit. Jika jumlahnya lebih besar dari cLimit, nilai yang dikembalikan adalah 0xFFFFFFFF.

Keterangan

Enumerasi dapat dimulai ulang dengan memanggil fungsi ini lagi.

WNDOBJ_cEnumStart harus dipanggil saja:

Dalam konteks fungsi panggilan balik driver yang diberikan ke GDI dalam fungsi EngCreateWnd , atau fungsi DDI grafis tempat WNDOBJ diberikan.
Ketika utas panggilan memiliki kunci perangkat untuk memastikan bahwa tidak ada perubahan wilayah klien yang terjadi.

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

Lihat juga

Bagikan melalui