enumerasi CM_NOTIFY_ACTION (cfgmgr32.h)

Artikel
03/08/2023

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

Bagikan melalui