Fungsi GetMsgProc
-Deskripsi
Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW. Sistem memanggil fungsi ini setiap kali fungsi GetMessage atau PeekMessageA/PeekMessageW telah mengambil pesan dari antrean pesan aplikasi. Sebelum mengembalikan pesan yang diambil ke pemanggil, sistem meneruskan pesan ke prosedur kait.
Jenis HOOKPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. GetMsgProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.
LRESULT CALLBACK GetMsgProc(
_In_ int code,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
-Parameter
code [in]
Jenis: int
Menentukan apakah prosedur kait harus memproses pesan. Jika kode HC_ACTION, prosedur kait harus memproses pesan. Jika kode kurang dari nol, prosedur kait harus meneruskan pesan ke fungsi CallNextHookEx tanpa pemrosesan lebih lanjut dan harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.
wParam [in]
Jenis: WPARAM
Menentukan apakah pesan telah dihapus dari antrean. Parameter ini bisa menjadi salah satu nilai berikut.
| Value | Makna |
|---|---|
| PM_NOREMOVE 0x0000 | Pesan belum dihapus dari antrean. (Aplikasi yang disebutFungsi PeekMessage , menentukan bendera PM_NOREMOVE .) |
| PM_REMOVE 0x0001 | Pesan telah dihapus dari antrean. (Aplikasi yang disebut GetMessage, atau disebut fungsi PeekMessage , menentukan bendera PM_REMOVE .) |
lParam [in]
Jenis: LPARAM
Penunjuk ke struktur MSG yang berisi detail tentang pesan.
-Kembali
Jika kode kurang dari nol, prosedur kait harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.
Jika kode lebih besar dari atau sama dengan nol, sangat disarankan agar Anda memanggil CallNextHookEx dan mengembalikan nilai yang dikembalikannya; jika tidak, aplikasi lain yang telah menginstal kait WH_GETMESSAGE tidak akan menerima pemberitahuan kait dan mungkin berperilaku salah sebagai akibatnya. Jika prosedur hook tidak memanggil CallNextHookEx, nilai pengembalian harus nol.
-Komentar
Prosedur hook GetMsgProc dapat memeriksa atau memodifikasi pesan.
Setelah prosedur kait mengembalikan kontrol ke sistem, fungsi GetMessage atau PeekMessageA/PeekMessageW mengembalikan pesan, bersama dengan modifikasi apa pun, ke aplikasi yang awalnya memanggilnya.
Aplikasi menginstal prosedur kait ini dengan menentukan jenis kait WH_GETMESSAGE dan penunjuk ke prosedur kait dalam panggilan ke fungsi SetWindowsHookExA/SetWindowsHookExW.