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

Lihat juga

CM_Get_Child

CM_Reenumerate_DevNode_Ex

IRP_MN_SURPRISE_REMOVAL