fungsi CM_Add_IDW (cfgmgr32.h)

Fungsi CM_Add_ID menambahkan ID perangkat tertentu (jika belum ada) ke daftar ID perangkat kerasinstans perangkat atau daftar ID yang kompatibel.

Sintaks

CMAPI CONFIGRET CM_Add_IDW(
  [in] DEVINST dnDevInst,
  [in] PWSTR   pszID,
  [in] ULONG   ulFlags
);

Parameter

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.

[in] pszID

Penunjuk yang disediakan penelepon ke string ID perangkat yang dihentikan NULL.

[in] ulFlags

Konstanta bendera yang disediakan penelepon yang menentukan daftar tempat ID perangkat yang disediakan harus ditambahkan. Konstanta bendera berikut valid.

Mengembalikan 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

Fungsi CM_Add_ID hanya dapat digunakan ketika dnDevInst mewakili perangkat yang dijumlahkan akar. Untuk perangkat lain, driver bus melaporkan perangkat keras dan ID yang kompatibel saat menghitung perangkat anak setelah menerima IRP_MN_QUERY_ID.

Setiap ID perangkat yang ditambahkan dianggap kurang kompatibel daripada ID yang sudah ada dalam daftar yang ditentukan. Untuk informasi tentang ID perangkat, ID perangkat keras, dan ID yang kompatibel, lihat String Identifikasi Perangkat.

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

Lihat juga

CM_Add_ID_Ex

CM_Get_Child