fungsi CM_Reenumerate_DevNode (cfgmgr32.h)
Fungsi CM_Reenumerate_DevNode menghitung perangkat yang diidentifikasi oleh simpul perangkat tertentu dan semua turunannya.
Sintaks
CMAPI CONFIGRET CM_Reenumerate_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parameter
[in] dnDevInst
Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.
[in] ulFlags
Bendera yang disediakan penelepon yang menentukan bagaimana reenumerasi harus terjadi. Parameter ini dapat diatur ke kombinasi bendera berikut, seperti yang disebutkan:
CM_REENUMERATE_ASYNCHRONOUS
Reenumerasi harus terjadi secara asinkron. Panggilan ke fungsi ini kembali segera setelah manajer PnP menerima permintaan reenumerasi. Jika bendera ini diatur, bendera CM_REENUMERATE_SYNCHRONOUS juga tidak boleh diatur.
CM_REENUMERATE_NORMAL
Menentukan perilaku reenumerasi default, di mana reenumerasi terjadi secara sinkron. Bendera ini secara fungsional setara dengan CM_REENUMERATE_SYNCHRONOUS.
CM_REENUMERATE_RETRY_INSTALLATION
Menentukan bahwa Plug and Play harus melakukan upaya lain untuk menginstal perangkat apa pun dalam subtree yang ditentukan yang telah terdeteksi tetapi belum dikonfigurasi, atau ditandai sebagai memerlukan penginstalan ulang, atau penginstalan mana yang harus diselesaikan. Bendera ini dapat diatur bersama dengan bendera CM_REENUMERATE_SYNCHRONOUS atau bendera CM_REENUMERATE_ASYNCHRONOUS.
Bendera ini harus digunakan dengan sangat hati-hati, karena dapat menyebabkan manajer PnP meminta pengguna untuk melakukan penginstalan perangkat tersebut. Saat ini, hanya komponen seperti Pengelola Perangkat dan Wizard Perangkat Keras yang menggunakan bendera ini, untuk memungkinkan pengguna mencoba kembali penginstalan perangkat yang mungkin sudah terdeteksi tetapi saat ini tidak diinstal.
CM_REENUMERATE_SYNCHRONOUS
Reenumerasi harus terjadi secara sinkron. Panggilan ke fungsi ini kembali ketika semua perangkat dalam subtree yang ditentukan telah dienumerasi ulang. Jika bendera ini diatur, bendera CM_REENUMERATE_ASYNCHRONOUS juga tidak boleh diatur. Bendera ini secara fungsional setara dengan CM_REENUMERATE_NORMAL.
Menampilkan nilai
Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.
Keterangan
Jika simpul perangkat yang ditentukan mewakili perangkat keras atau bus perangkat lunak, manajer PnP meminta driver perangkat untuk daftar turunan, maka mencoba mengonfigurasi dan memulai perangkat anak apa pun yang sebelumnya tidak dikonfigurasi. Manajer PnP juga memulai penghapusan kejutan perangkat yang tidak lagi ada (lihat IRP_MN_SURPRISE_REMOVAL).
Penelepon fungsi ini harus memiliki SeLoadDriverPrivilege. (Hak istimewa dijelaskan dalam dokumentasi Microsoft Windows SDK.)
Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal, lihat CM_Get_Child.
Persyaratan
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | cfgmgr32.h (termasuk Cfgmgr32.h) |
| Pustaka | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |