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.

Attribute Nilai
Kunci properti DEVPKEY_Device_ContainerId
Pengidentifikasi tipe data properti DEVPROP_TYPE_GUID
Akses properti Akses baca-saja oleh aplikasi penginstalan dan alat penginstal
Dilokalkan? Tidak

Remarks

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 devnode yang berasal dari perangkat fisik.

  • Pengguna atau aplikasi disajikan dengan tampilan perangkat yang ber sentris perangkat alih-alih tampilan tradisional yang ber sentris fungsi.

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.

Requirements

Versi: Windows 7 dan versi Windows yang lebih baru

Header: Devpkey.h (termasuk Devpkey.h)

Baca juga

ID Kontainer

SetupDiGetDeviceProperty