Share via

DEVPKEY_Device_ContainerId

  • Artikel

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)

Lihat juga

ID Kontainer

SetupDiGetDeviceProperty