Fungsi DriverCallback (mmiscapi.h)

Artikel
03/15/2023

Memanggil fungsi panggilan balik, mengirim pesan ke jendela, atau membuka blokir utas. Tindakan tergantung pada nilai bendera pemberitahuan. Fungsi ini dimaksudkan untuk digunakan hanya dalam fungsi DriverProc dari driver yang dapat diinstal.

Sintaks

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parameter

dwCallback

Alamat fungsi panggilan balik, handel jendela, atau handel tugas, tergantung pada bendera yang ditentukan dalam parameter dwFlags .

dwFlags

Bendera pemberitahuan. Ini bisa menjadi salah satu nilai ini:

Nilai	Makna
DCB_NOSWITCH	Sistem dicegah untuk beralih tumpukan. Nilai ini hanya digunakan jika ruang tumpukan yang cukup untuk fungsi panggilan balik diketahui ada.
DCB_FUNCTION	Parameter dwCallback adalah alamat fungsi panggilan balik yang ditentukan aplikasi. Sistem mengirim pesan panggilan balik ke fungsi panggilan balik.
DCB_WINDOW	Parameter dwCallback adalah handel dari jendela yang ditentukan aplikasi. Sistem mengirimkan pemberitahuan berikutnya ke jendela.
DCB_TASK	Parameter dwCallback adalah handel dari aplikasi atau tugas. Sistem mengirimkan pemberitahuan berikutnya ke aplikasi atau tugas.

hDevice

Menangani instans driver yang dapat diinstal.

dwMsg

Nilai pesan.

dwUser

Data instans pengguna 32-bit yang disediakan oleh aplikasi saat perangkat dibuka.

dwParam1

Parameter yang bergantung pada pesan 32-bit.

dwParam2

Parameter yang bergantung pada pesan 32-bit.

Mengembalikan nilai

Mengembalikan TRUE jika berhasil atau FALSE jika parameter tidak valid atau antrean pesan tugas penuh.

Keterangan

Klien menentukan cara memberi tahunya saat perangkat dibuka. Bendera DCB_FUNCTION dan DCB_WINDOW setara dengan kata urutan tinggi dari bendera yang sesuai CALLBACK_FUNCTION dan CALLBACK_WINDOW yang ditentukan dalam parameter lParam2 dari pesan DRV_OPEN saat perangkat dibuka.

Jika pemberitahuan dicapai dengan fungsi panggilan balik, hdrvr, msg, dwUser, dwParam1, dan dwParam2 diteruskan ke fungsi panggilan balik. Jika pemberitahuan dicapai dengan menggunakan jendela, hanya msg, hdrvr, dan dwParam1 yang diteruskan ke jendela.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mmiscapi.h (termasuk Mmiscapi.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Fungsi Driver

Driver yang Dapat Diinstal

Bagikan melalui