Fungsi MouseProc

Artikel
07/01/2023

Deskripsi

Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW . Sistem memanggil fungsi ini setiap kali aplikasi memanggil fungsi GetMessage atau PeekMessageA/PeekMessageW dan ada pesan mouse yang akan diproses.

Jenis HOOKPROC menentukan penunjuk ke fungsi panggilan balik ini. MouseProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.

LRESULT CALLBACK MouseProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Parameter

nCode [in]

Jenis: int

Kode yang digunakan prosedur kait untuk menentukan cara memproses pesan.

Jika nCode kurang dari nol, prosedur hook harus meneruskan pesan ke fungsi CallNextHookEx tanpa pemrosesan lebih lanjut dan harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
HC_ACTION 0	Parameter wParam dan lParam berisi informasi tentang pesan mouse.
HC_NOREMOVE 3	Parameter wParam dan lParam berisi informasi tentang pesan mouse, dan pesan mouse belum dihapus dari antrean pesan. (Aplikasi yang disebut fungsi PeekMessage , menentukan bendera PM_NOREMOVE .)

wParam [in]

Jenis: WPARAM

Pengidentifikasi pesan mouse.

lParam [in]

Jenis: LPARAM

Penunjuk ke struktur MOUSEHOOKSTRUCT .

Mengembalikan

Jenis: LRESULT

Jika nCode kurang dari nol, prosedur hook harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.

Jika nCode lebih besar dari atau sama dengan nol, dan prosedur kait tidak memproses pesan, sangat disarankan agar Anda memanggil CallNextHookEx dan mengembalikan nilai yang dikembalikannya; jika tidak, aplikasi lain yang telah diinstal WH_MOUSE kait tidak akan menerima pemberitahuan kait dan mungkin bertingkah tidak benar sebagai akibatnya.

Jika prosedur kait memproses pesan, itu dapat mengembalikan nilai bukan nol untuk mencegah sistem meneruskan pesan ke prosedur jendela target.

Keterangan

Aplikasi menginstal prosedur kait dengan menentukan jenis hook WH_MOUSE dan penunjuk ke prosedur kait dalam panggilan ke fungsi SetWindowsHookExA/SetWindowsHookExW .

Prosedur kait tidak boleh menginstal fungsi panggilan balik WH_JOURNALPLAYBACK .

Hook ini dapat dipanggil dalam konteks utas yang memasangnya. Panggilan dilakukan dengan mengirim pesan ke utas yang menginstal hook. Oleh karena itu, utas yang memasang hook harus memiliki perulangan pesan.