CM_Get_Device_ID_ListW (cfgmgr32.h)
Fungsi CM_Get_Device_ID_List mengambil daftar ID instans perangkat untuk instans perangkat komputer lokal.
Sintaks
CMAPI CONFIGRET CM_Get_Device_ID_ListW(
[in, optional] PCWSTR pszFilter,
[out] PZZWSTR Buffer,
[in] ULONG BufferLen,
[in] ULONG ulFlags
);
Parameter
[in, optional] pszFilter
Penunjuk yang disediakan penelepon ke string karakter yang diatur ke subset pengidentifikasi instans perangkat (ID) komputer, atau ke NULL. Lihat deskripsi ulFlags berikut.
[out] Buffer
Alamat buffer untuk menerima sekumpulan string pengidentifikasi instans perangkat yang dihentikan NULL. Akhir set dihentikan oleh NULL tambahan. Ukuran buffer yang diperlukan harus diperoleh dengan memanggil CM_Get_Device_ID_List_Size.
[in] BufferLen
Panjang yang disediakan pemanggil, dalam karakter, dari buffer yang ditentukan oleh Buffer.
[in] ulFlags
Salah satu bendera bit yang disediakan pemanggil berikut yang menentukan filter pencarian:
CM_GETIDLIST_FILTER_BUSRELATIONS
Jika bendera ini diatur, pszFilter harus menentukan pengidentifikasi instans perangkat. Fungsi mengembalikan ID instans perangkat untuk relasi bus dari instans perangkat yang ditentukan.
CM_GETIDLIST_FILTER_CLASS (Windows 7 dan versi Windows yang lebih baru)
Jika bendera ini diatur, pszFilter berisi string yang menentukan GUID kelas penyiapan perangkat . Daftar yang dikembalikan berisi instans perangkat yang propertinya (direferensikan oleh konstanta CM_DRP_CLASSGUID) cocok dengan GUID kelas penyiapan perangkat yang ditentukan.
Konstanta CM_DRP_CLASSGUID ditentukan dalam Cfgmgr32.h.
CM_GETIDLIST_FILTER_PRESENT (Windows 7 dan versi Windows yang lebih baru)
Jika bendera ini diatur, daftar yang dikembalikan hanya berisi instans perangkat yang saat ini ada di sistem. Nilai ini dapat dikombinasikan dengan nilai ulFlags lainnya, seperti CM_GETIDLIST_FILTER_CLASS.
CM_GETIDLIST_FILTER_TRANSPORTRELATIONS (Windows 7 dan versi Windows yang lebih baru)
Jika bendera ini diatur, pszFilter harus menentukan pengidentifikasi instans perangkat dari simpul perangkat komposit (devnode).
Fungsi mengembalikan pengidentifikasi instans perangkat dari devnode yang mewakili hubungan transportasi dari devnode komposit yang ditentukan.
Untuk informasi selengkapnya tentang devnode komposit dan hubungan transportasi, lihat bagian Keterangan berikut ini.
CM_GETIDLIST_DONOTGENERATE
Digunakan hanya dengan CM_GETIDLIST_FILTER_SERVICE. Jika diatur, dan jika pohon perangkat tidak berisi devnode untuk layanan yang ditentukan, bendera ini mencegah fungsi membuat devnode untuk layanan.
CM_GETIDLIST_FILTER_EJECTRELATIONS
Jika bendera ini diatur, pszFilter harus menentukan pengidentifikasi instans perangkat. Fungsi mengembalikan ID instans perangkat untuk relasi ejeksi instans perangkat yang ditentukan.
CM_GETIDLIST_FILTER_ENUMERATOR
Jika bendera ini diatur, pszFilter harus menentukan nama enumerator perangkat, secara opsional diikuti oleh ID perangkat. Format string adalah EnumeratorName\<DeviceID>, seperti ROOT atau ROOT\*PNP0500.
Jika pszFilter hanya menyediakan nama enumerator, fungsi mengembalikan ID instans perangkat untuk instans setiap perangkat yang terkait dengan enumerator. Nama enumerator dapat diperoleh dengan memanggil CM_Enumerate_Enumerators.
Jika pszFilter memasok enumerator dan ID perangkat, fungsi mengembalikan ID instans perangkat hanya untuk instans perangkat yang ditentukan yang terkait dengan enumerator.
CM_GETIDLIST_FILTER_NONE
Jika bendera ini diatur, pszFilter diabaikan, dan daftar semua perangkat pada sistem dikembalikan.
CM_GETIDLIST_FILTER_POWERRELATIONS
Jika bendera ini diatur, pszFilter harus menentukan pengidentifikasi instans perangkat. Fungsi mengembalikan ID instans perangkat untuk relasi daya instans perangkat yang ditentukan.
CM_GETIDLIST_FILTER_REMOVALRELATIONS
Jika bendera ini diatur, pszFilter harus menentukan pengidentifikasi instans perangkat. Fungsi mengembalikan ID instans perangkat untuk relasi penghapusan instans perangkat yang ditentukan.
CM_GETIDLIST_FILTER_SERVICE
Jika bendera ini diatur, pszFilter harus menentukan nama layanan Microsoft Windows (biasanya driver). Fungsi ini mengembalikan ID instans perangkat untuk instans perangkat yang dikontrol oleh layanan yang ditentukan.
Perhatikan bahwa jika pohon perangkat tidak berisi devnode untuk layanan yang ditentukan, fungsi ini membuatnya secara default. Untuk menghambat perilaku ini, atur juga CM_GETIDLIST_DONOTGENERATE.
Jika tidak ada bendera filter pencarian yang ditentukan, fungsi mengembalikan semua ID instans perangkat untuk semua instans perangkat.
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
Dimulai dengan Windows 7, perangkat yang mendukung beberapa jalur transportasi untuk data berbasis paket disebut sebagai perangkat komposit dan diwakili oleh devnodekomposit. Devnode komposit secara logis mewakili perangkat komposit kepada pengguna dan aplikasi sebagai satu perangkat, meskipun devnode komposit dapat memiliki beberapa jalur ke perangkat fisik.
Setiap jalur transportasi aktif ke perangkat fisik diwakili oleh devnode transportasi dan disebut sebagai relasi transportasi untuk perangkat komposit.
Devnode komposit (tetapi bukan devnode transportasi terkait) mengekspos antarmuka perangkat ke aplikasi dan sistem. Ketika aplikasi menggunakan antarmuka perangkat publik ini, perangkat komposit merutekan data berbasis paket ke satu atau beberapa devnode transportasi ini, yang kemudian mengangkut data ke perangkat fisik.
Misalnya, jika ponsel fisik secara bersamaan terhubung ke komputer pada USB dan bus Bluetooth, setiap bus menghitung devnode transportasi anak di bus tersebut untuk mewakili koneksi fisik perangkat.
Dalam hal ini, jika Anda mengatur bendera CM_GETIDLIST_FILTER_TRANSPORTRELATIONS di ulFlags dan menentukan ID instans perangkat devnode komposit ponsel di pszFilter, fungsi mengembalikan ID instans perangkat untuk dua devnode transportasi dalam parameter Buffer .
Untuk informasi selengkapnya tentang ID instans perangkat, lihat String Identifikasi Perangkat.
Catatan
Header cfgmgr32.h mendefinisikan CM_Get_Device_ID_List sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Universal |
| Header | cfgmgr32.h (termasuk Cfgmgr32.h) |
| Pustaka | Cfgmgr32.lib |
| DLL | CfgMgr32.dll |