fungsi CM_Add_IDA (cfgmgr32.h)

Artikel
02/23/2024

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

Sintaks

CMAPI CONFIGRET CM_Add_IDA(
  DEVINST dnDevInst,
  PSTR    pszID,
  ULONG   ulFlags
);

Parameter

dnDevInst

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

pszID

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

ulFlags

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

Konstanta Bendera	Definisi
CM_ADD_ID_COMPATIBLE	ID perangkat yang ditentukan harus ditambahkan ke daftar ID yang kompatibel dengan instans perangkat tertentu.
CM_ADD_ID_HARDWARE	ID perangkat yang ditentukan harus ditambahkan ke daftar ID perangkat keras instans perangkat tertentu.

Mengembalikan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia 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.

Pemanggil 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

Persyaratan	Nilai
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

Lihat juga

CM_Add_ID_Ex
CM_Get_Child

Bagikan melalui