Freigeben über


DEVPKEY_Device_ContainerId

Die DEVPKEY_Device_ContainerId Geräteeigenschaft wird vom Plug & Play-Manager (PnP) verwendet, um einen oder mehrere Geräteknoten (Devnodes) in einem Gerätecontainer zu gruppieren, der eine instance eines physischen Geräts darstellt.

attribute Wert
Eigenschaftenschlüssel DEVPKEY_Device_ContainerId
Eigenschaftsdatentypbezeichner DEVPROP_TYPE_GUID
Eigenschaftenzugriff Schreibgeschützter Zugriff durch Installationsanwendungen und Installationsprogramme
Lokalisierte? Nein

Bemerkungen

Ab Windows 7 verwendet der PnP-Manager den Gerätecontainer und seinen Bezeichner (ContainerID), um einen oder mehrere Devnodes zu gruppieren, die von jedem instance eines bestimmten physischen Geräts stammen und zu diesen gehören. Auf die ContainerID für ein Gerät instance wird über die eigenschaft DEVPKEY_Device_ContainerId device verwiesen.

Wenn Sie alle Devnodes, die von einem instance eines einzelnen Geräts stammen, in Containern gruppieren, erzielen Sie die folgenden Ergebnisse:

  • Das Betriebssystem kann bestimmen, wie die Funktionalität zwischen Devnodes zusammenhängt , die von einem physischen Gerät stammen.

  • Der Benutzer oder die Anwendungen werden mit einer gerätezentrierten Ansicht von Geräten anstelle der herkömmlichen funktionszentrierten Ansicht angezeigt.

Die DEVPKEY_Device_ContainerId kann verwendet werden, um die Gerätecontainergruppierung von Devnodes in einem System zu bestimmen. Für einen bestimmten Devnode können Sie alle Devnodes ermitteln, die zum gleichen Container gehören, indem Sie die folgenden Schritte ausführen:

  • Rufen Sie CM_Get_DevNode_Property oder SetupDiGetDeviceProperty auf, um DEVPKEY_Device_ContainerId für den angegebenen Devnode abzufragen. Windows gibt den ContainerID-GUID-Wert für den Gerätecontainer zurück, zu dem dieser Devnode gehört.

  • Listet alle Devnodes auf dem Computer auf, und fragt jeden Devnode nach seiner DEVPKEY_Device_ContainerId ab. Jeder ContainerId-Wert, der mit dem ContainerId-Wert des ursprünglichen Devnodes übereinstimmt, ist Teil desselben Containers.

Hinweis Alle Devnodes , die zu einem Container auf einem bestimmten Bustyp gehören, müssen denselben ContainerID-Wert verwenden.

Weitere Informationen zu ContainerIDs finden Sie unter Container-IDs.

Anforderungen

Version: Windows 7 und höhere Versionen von Windows

Header: Devpkey.h (devpkey.h einschließen)

Weitere Informationen

Container-IDs

SetupDiGetDeviceProperty