WM_DEVICECHANGE pesan

Artikel
06/22/2023

Memberi tahu aplikasi perubahan pada konfigurasi perangkat keras perangkat atau komputer.

Jendela menerima pesan ini melalui fungsi WindowProc-nya .

LRESULT CALLBACK WindowProc(HWND   hwnd,     // handle to window
                            UINT   uMsg,     // WM_DEVICECHANGE
                            WPARAM wParam,   // device-change event
                            LPARAM lParam ); // event-specific data

Parameter

hwnd

Handel ke jendela.

uMsg

Pengidentifikasi WM_DEVICECHANGE .

wParam

Peristiwa yang telah terjadi. Parameter ini bisa menjadi salah satu nilai berikut dari file header Dbt.h.

Nilai	Makna
DBT_DEVNODES_CHANGED0x0007	Perangkat telah ditambahkan atau dihapus dari sistem.
DBT_QUERYCHANGECONFIG0x0017	Izin diminta untuk mengubah konfigurasi saat ini (dok atau batalkan dok).
DBT_CONFIGCHANGED0x0018	Konfigurasi saat ini telah berubah, karena dock atau undock.
DBT_CONFIGCHANGECANCELED0x0019	Permintaan untuk mengubah konfigurasi saat ini (dock atau undock) telah dibatalkan.
DBT_DEVICEARRIVAL0x8000	Perangkat atau sepotong media telah dimasukkan dan sekarang tersedia.
DBT_DEVICEQUERYREMOVE0x8001	Izin diminta untuk menghapus perangkat atau bagian media. Aplikasi apa pun dapat menolak permintaan ini dan membatalkan penghapusan.
DBT_DEVICEQUERYREMOVEFAILED0x8002	Permintaan untuk menghapus perangkat atau bagian media telah dibatalkan.
DBT_DEVICEREMOVEPENDING0x8003	Perangkat atau sepotong media akan dihapus. Tidak dapat ditolak.
DBT_DEVICEREMOVECOMPLETE0x8004	Perangkat atau bagian media telah dihapus.
DBT_DEVICETYPESPECIFIC0x8005	Peristiwa khusus perangkat telah terjadi.
DBT_CUSTOMEVENT0x8006	Terjadi peristiwa kustom.
DBT_USERDEFINED0xFFFF	Arti pesan ini ditentukan pengguna.

lParam

Penunjuk ke struktur yang berisi data khusus peristiwa. Formatnya tergantung pada nilai parameter wParam . Untuk informasi selengkapnya, lihat dokumentasi untuk setiap peristiwa.

Nilai kembali

Kembalikan TRUE untuk memberikan permintaan.

Kembalikan BROADCAST_QUERY_DENY untuk menolak permintaan.

Keterangan

Untuk perangkat yang menawarkan fitur yang dapat dikontrol perangkat lunak, seperti ejeksi dan penguncian, sistem biasanya mengirim pesan DBT_DEVICEREMOVEPENDING untuk memungkinkan aplikasi dan driver perangkat mengakhiri penggunaan perangkat dengan baik. Jika sistem secara paksa menghapus perangkat, sistem mungkin tidak mengirim pesan DBT_DEVICEQUERYREMOVE sebelum melakukannya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Server minimum yang didukung	Windows Server 2003
Header	Winuser.h (termasuk Windows.h atau Dbt.h)

Lihat juga

DBT_CONFIGCHANGECANCELED
DBT_CONFIGCHANGED
DBT_CUSTOMEVENT
DBT_DEVICEARRIVAL
DBT_DEVICEQUERYREMOVE
DBT_DEVICEQUERYREMOVEFAILED
DBT_DEVICEREMOVECOMPLETE
DBT_DEVICEREMOVEPENDING
DBT_DEVICETYPESPECIFIC
DBT_DEVNODES_CHANGED
DBT_QUERYCHANGECONFIG
DBT_USERDEFINED

Bagikan melalui