DEVPKEY_Device_ContainerId
Properti perangkat DEVPKEY_Device_ContainerId digunakan oleh manajer Plug and Play (PnP) untuk mengelompokkan satu atau beberapa simpul perangkat (devnode) ke dalam kontainer perangkat yang mewakili instans perangkat fisik.
| Atribut | Nilai |
|---|---|
| Kunci properti | DEVPKEY_Device_ContainerId |
| Pengidentifikasi tipe data properti | DEVPROP_TYPE_GUID |
| Akses properti | Akses baca-saja oleh aplikasi penginstalan dan penginstal |
| Lokal? | Tidak |
Keterangan
Dimulai dengan Windows 7, manajer PnP menggunakan kontainer perangkat dan pengidentifikasinya (ContainerID) untuk mengelompokkan satu atau beberapa devnode yang berasal dari dan milik setiap instans perangkat fisik tertentu. ContainerID untuk instans perangkat dirujuk melalui properti perangkat DEVPKEY_Device_ContainerId.
Saat Anda mengelompokkan semua devnode yang berasal dari instans satu perangkat ke dalam kontainer, Anda mencapai hasil berikut:
Sistem operasi dapat menentukan bagaimana fungsionalitas terkait di antara devnodes yang berasal dari perangkat fisik.
Pengguna atau aplikasi disajikan dengan tampilan perangkat yang bersentris perangkat alih-alih tampilan fungsi-sentris tradisional.
DEVPKEY_Device_ContainerId dapat digunakan untuk menentukan pengelompokan kontainer perangkat devnode dalam sistem. Untuk devnode tertentu, Anda dapat menentukan semua devnode yang termasuk dalam kontainer yang sama dengan menyelesaikan langkah-langkah berikut:
Panggil CM_Get_DevNode_Property atau SetupDiGetDeviceProperty untuk mengkueri DEVPKEY_Device_ContainerId untuk devnode yang diberikan. Windows mengembalikan nilai GUID ContainerID untuk kontainer perangkat tempat devnode tersebut berada.
Hitung semua devnode di komputer dan kueri setiap devnode untuk DEVPKEY_Device_ContainerId. Setiap nilai ContainerId yang cocok dengan nilai ContainerId dari devnode asli adalah bagian dari kontainer yang sama.
Catatan Semua devnode yang termasuk dalam kontainer pada jenis bus tertentu harus memiliki nilai ContainerID yang sama.
Untuk informasi selengkapnya tentang ContainerID, lihat ID Kontainer.
Persyaratan
Versi: Windows 7 dan versi Windows yang lebih baru
Header: Devpkey.h (sertakan Devpkey.h)