Fungsi panggilan balik ForegroundIdleProc

Artikel
07/01/2023

Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW . Sistem memanggil fungsi ini setiap kali utas latar depan akan menjadi menganggur.

Sintaks

DWORD CALLBACK ForegroundIdleProc(
  _In_ int   code,
       DWORD wParam,
       LONG  lParam
);

Parameter

code [in]
Jenis: int

Jika kodeHC_ACTION, prosedur kait harus memproses pesan. Jika kode kurang dari nol, prosedur hook harus meneruskan pesan ke fungsi CallNextHookEx tanpa pemrosesan lebih lanjut dan harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.
wParam
Jenis: DWORD

Parameter ini tidak digunakan.
lParam
Jenis: LONG

Parameter ini tidak digunakan.

Nilai kembali

Jenis:****

Mengetik: DWORD

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_FOREGROUNDIDLE tidak akan menerima pemberitahuan kait dan mungkin bertingkah salah sebagai akibatnya. Jika prosedur hook tidak memanggil CallNextHookEx, nilai yang dikembalikan harus nol.

Keterangan

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

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

Saat memproses fungsi panggilan balik ini, hindari memanggil fungsi apa pun yang mengambil pesan jendela dari antrean pesan utas panggilan. Ini termasuk GetMessage, PeekMessageA/PeekMessageW, kotak dialog modal, dan fungsi COM. Memanggil fungsi tersebut dapat mengakibatkan utas tidak kembali dari GetMessage atau WaitMessage ketika ada pesan dalam antrean pesan utas panggilan.

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)

Lihat juga

Referensi

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

Konseptual

Hook

Bagikan melalui