enumerasi CM_NOTIFY_ACTION (cfgmgr32.h)

Enumerasi ini mengidentifikasi Plug and Play jenis peristiwa perangkat.

Sintaks

typedef enum _CM_NOTIFY_ACTION {
  CM_NOTIFY_ACTION_DEVICEINTERFACEARRIVAL = 0,
  CM_NOTIFY_ACTION_DEVICEINTERFACEREMOVAL,
  CM_NOTIFY_ACTION_DEVICEQUERYREMOVE,
  CM_NOTIFY_ACTION_DEVICEQUERYREMOVEFAILED,
  CM_NOTIFY_ACTION_DEVICEREMOVEPENDING,
  CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE,
  CM_NOTIFY_ACTION_DEVICECUSTOMEVENT,
  CM_NOTIFY_ACTION_DEVICEINSTANCEENUMERATED,
  CM_NOTIFY_ACTION_DEVICEINSTANCESTARTED,
  CM_NOTIFY_ACTION_DEVICEINSTANCEREMOVED,
  CM_NOTIFY_ACTION_MAX
} CM_NOTIFY_ACTION, *PCM_NOTIFY_ACTION;

Konstanta

CM_NOTIFY_ACTION_DEVICEINTERFACEARRIVAL Nilai: 0 Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE. Tindakan ini menunjukkan bahwa antarmuka perangkat yang memenuhi kriteria filter Anda telah diaktifkan.
CM_NOTIFY_ACTION_DEVICEINTERFACEREMOVAL Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE. Tindakan ini menunjukkan bahwa antarmuka perangkat yang memenuhi kriteria filter Anda telah dinonaktifkan.
CM_NOTIFY_ACTION_DEVICEQUERYREMOVE Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Tindakan ini menunjukkan bahwa perangkat sedang dihapus kuerinya. Untuk memungkinkan penghapusan kueri berhasil, panggil CloseHandle untuk menutup handel apa pun yang telah Anda buka ke perangkat. Jika Anda tidak melakukan ini, handel terbuka Mencegah penghapusan kueri perangkat ini berhasil. Lihat Mendaftar untuk Pemberitahuan Kedatangan Antarmuka Perangkat dan Penghapusan Perangkat untuk informasi selengkapnya. Untuk mem-veto penghapusan kueri, kembalikan ERROR_CANCELLED. Namun, disarankan agar Anda tidak mem-veto penghapusan kueri dan memungkinkannya terjadi dengan menutup handel apa pun yang telah Anda buka ke perangkat.
CM_NOTIFY_ACTION_DEVICEQUERYREMOVEFAILED Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Tindakan ini menunjukkan bahwa penghapusan kueri perangkat gagal. Jika Anda menutup handel ke perangkat ini selama pemberitahuan CM_NOTIFY_ACTION_DEVICEQUERYREMOVE sebelumnya, buka handel baru ke perangkat untuk terus mengirim permintaan I/O ke perangkat tersebut. Lihat Mendaftar untuk Pemberitahuan Kedatangan Antarmuka Perangkat dan Penghapusan Perangkat untuk informasi selengkapnya.
CM_NOTIFY_ACTION_DEVICEREMOVEPENDING Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Perangkat akan dihapus. Jika Anda masih memiliki handel terbuka ke perangkat, panggil CloseHandle untuk menutup handel perangkat. Lihat Mendaftar untuk Pemberitahuan Kedatangan Antarmuka Perangkat dan Penghapusan Perangkat untuk informasi selengkapnya. Sistem dapat mengirim pemberitahuan CM_NOTIFY_ACTION_DEVICEREMOVEPENDING tanpa mengirim pesan CM_NOTIFY_ACTION_DEVICEQUERYREMOVE yang sesuai. Dalam kasus seperti itu, aplikasi dan driver harus pulih dari hilangnya perangkat sebaik mungkin.
CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Perangkat telah dihapus. Jika Anda masih memiliki handel terbuka ke perangkat, panggil CloseHandle untuk menutup handel perangkat. Lihat Mendaftar untuk Pemberitahuan Kedatangan Antarmuka Perangkat dan Penghapusan Perangkat untuk informasi selengkapnya. Sistem dapat mengirim pemberitahuan CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE tanpa mengirim pesan CM_NOTIFY_ACTION_DEVICEQUERYREMOVE atau CM_NOTIFY_ACTION_DEVICEREMOVEPENDING yang sesuai. Dalam kasus seperti itu, aplikasi dan driver harus pulih dari hilangnya perangkat sebaik mungkin.
CM_NOTIFY_ACTION_DEVICECUSTOMEVENT Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Tindakan ini dikirim ketika peristiwa kustom yang ditentukan driver telah terjadi.
CM_NOTIFY_ACTION_DEVICEINSTANCEENUMERATED Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Tindakan ini dikirim ketika instans perangkat baru yang memenuhi kriteria filter Anda telah dijumlahkan.
CM_NOTIFY_ACTION_DEVICEINSTANCESTARTED Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Tindakan ini dikirim ketika instans perangkat yang memenuhi kriteria filter Anda dimulai.
CM_NOTIFY_ACTION_DEVICEINSTANCEREMOVED Untuk nilai ini, atur anggota FilterType dari struktur CM_NOTIFY_FILTER untuk CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Tindakan ini dikirim ketika instans perangkat yang memenuhi kriteria filter Anda tidak lagi ada.
CM_NOTIFY_ACTION_MAX Jangan gunakan.

Keterangan

Ketika driver memanggil fungsi CM_Register_Notification , parameter pCallback berisi pointer ke rutinitas untuk dipanggil ketika peristiwa PnP tertentu terjadi. Parameter Tindakan rutin panggilan balik adalah nilai dari enumerasi CM_NOTIFY_ACTION .

Persyaratan

Persyaratan	Nilai
Header	cfgmgr32.h

Lihat juga

CM_NOTIFY_FILTER

CM_Register_Notification