Fungsi DebugProc

Artikel
07/01/2023

Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW . Sistem memanggil fungsi ini sebelum memanggil prosedur kait yang terkait dengan semua jenis kait. Sistem meneruskan informasi tentang hook yang akan dipanggil ke prosedur kait DebugProc , yang memeriksa informasi dan menentukan apakah akan memungkinkan hook dipanggil.

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

Sintaks

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

Parameter

nCode [in]
Jenis: int

Menentukan apakah prosedur kait harus memproses pesan. Jika nCode HC_ACTION, prosedur kait harus 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.

wParam [in]
Jenis: WPARAM

Jenis hook yang akan dipanggil. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
WH_CALLWNDPROC 4	Menginstal prosedur kait yang memantau pesan yang dikirim ke prosedur jendela. Untuk informasi selengkapnya, lihat deskripsi prosedur hook [CallWndProc](callwndproc.md).
WH_CALLWNDPROCRET 12	Menginstal prosedur kait yang memantau pesan yang baru saja diproses oleh prosedur jendela. Untuk informasi selengkapnya, lihat deskripsi prosedur hook CallWndRetProc .
WH_CBT 5	Menginstal prosedur kait yang menerima pemberitahuan yang berguna untuk aplikasi CBT. Untuk informasi selengkapnya, lihat deskripsi prosedur hook [CBTProc](cbtproc.md).
WH_DEBUG 9	Menginstal prosedur kait yang berguna untuk men-debug prosedur kait lainnya. Untuk informasi selengkapnya, lihat deskripsi prosedur hook DebugProc .
WH_GETMESSAGE 3	Menginstal prosedur hook yang memantau pesan yang diposting ke antrean pesan. Untuk informasi selengkapnya, lihat deskripsi prosedur hookGetMsgProc .
WH_JOURNALPLAYBACK 1	Menginstal prosedur hook yang memposting pesan yang sebelumnya direkam oleh prosedur hook WH_JOURNALRECORD . Untuk informasi selengkapnya, lihat deskripsi prosedur hook JournalPlaybackProc .
WH_JOURNALRECORD 0	Menginstal prosedur kait yang merekam pesan input yang diposting ke antrean pesan sistem. Kait ini berguna untuk merekam makro. Untuk informasi selengkapnya, lihat deskripsi prosedur hook JournalRecordProc .
WH_KEYBOARD 2	Menginstal prosedur kait yang memantau pesan penekanan tombol. Untuk informasi selengkapnya, lihat deskripsi prosedur hook KeyboardProc .
WH_MOUSE 7	Menginstal prosedur kait yang memantau pesan mouse. Untuk informasi selengkapnya, lihat deskripsi prosedur hook [MouseProc](mouseproc.md).
WH_MSGFILTER -1	Menginstal prosedur hook yang memantau pesan yang dihasilkan sebagai hasil dari peristiwa input dalam kotak dialog, kotak pesan, menu, atau bilah gulir. Prosedur kait memantau pesan-pesan ini hanya untuk aplikasi yang menginstal prosedur kait. Untuk informasi selengkapnya, lihat prosedur hook [MessageProc](messageproc.md).
WH_SHELL 10	Menginstal prosedur kait yang menerima pemberitahuan yang berguna untuk aplikasi Shell. Untuk informasi selengkapnya, lihat deskripsi prosedur kait [ShellProc](shellproc.md) dan bagian hook WH_SHELL .
WH_SYSMSGFILTER 6	Menginstal prosedur hook yang memantau pesan yang dihasilkan sebagai hasil dari peristiwa input dalam kotak dialog, kotak pesan, menu, atau bilah gulir. Prosedur kait memantau pesan-pesan ini untuk semua aplikasi dalam sistem. Untuk informasi selengkapnya, lihat deskripsi prosedur hook [SysMsgProc](sysmsgproc.md).

lParam [in]
Jenis: LPARAM

Penunjuk ke struktur DEBUGHOOKINFO yang berisi parameter yang akan diteruskan ke prosedur kait tujuan.

Menampilkan nilai

Jenis:****

Jenis: LRESULT

Untuk mencegah sistem memanggil kait, prosedur kait harus mengembalikan nilai bukan nol. Jika tidak, prosedur kait harus memanggil CallNextHookEx.

Keterangan

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

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)