DEVPKEY_Device_ContainerId

La proprietà del dispositivo DEVPKEY_Device_ContainerId viene usata dal manager Plug and Play (PnP) per raggruppare uno o più nodi del dispositivo (devnodes) in un contenitore di dispositivi che rappresenta un'istanza di un dispositivo fisico.

Attribute Value
Chiave della proprietà DEVPKEY_Device_ContainerId
Identificatore property-data-type DEVPROP_TYPE_GUID
Accesso alle proprietà Accesso in sola lettura da applicazioni di installazione e programmi di installazione
Localizzata? No

Remarks

A partire da Windows 7, il gestore PnP usa il contenitore di dispositivi e il relativo identificatore (ContainerID) per raggruppare uno o più devnodes che hanno avuto origine e appartengono a ogni istanza di un particolare dispositivo fisico. Viene fatto riferimento a ContainerID per un'istanza del dispositivo tramite la proprietà del dispositivo DEVPKEY_Device_ContainerId.

Quando si raggruppano tutti i nodi di sviluppo originati da un'istanza di un singolo dispositivo in contenitori, si ottengono i risultati seguenti:

  • Il sistema operativo può determinare in che modo la funzionalità è correlata tra gli elementi devnodes che hanno origine da un dispositivo fisico.

  • L'utente o le applicazioni vengono presentate con una visualizzazione incentrata sui dispositivi anziché la visualizzazione tradizionale incentrata sulle funzioni.

Il DEVPKEY_Device_ContainerId può essere usato per determinare il raggruppamento dei contenitori di dispositivi di devnodes in un sistema. Per un determinato devnode, è possibile determinare tutti i nodi di sviluppo che appartengono allo stesso contenitore completando i passaggi seguenti:

  • Chiamare CM_Get_DevNode_Property o SetupDiGetDeviceProperty per eseguire una query DEVPKEY_Device_ContainerId per il nodo devnode specificato. Windows restituisce il valore GUID ContainerID per il contenitore di dispositivi a cui appartiene tale nodo devnode.

  • Enumerare tutti gli elementi devnodes nel computer ed eseguire query su ogni nodo devnode per il relativo DEVPKEY_Device_ContainerId. Ogni valore ContainerId corrispondente al valore ContainerId del nodo devnode originale fa parte dello stesso contenitore.

Nota Tutti i devnodes che appartengono a un contenitore in un determinato tipo di bus devono condividere lo stesso valore ContainerID.

Per altre informazioni sugli ID contenitore, vedere ID contenitore.

Requirements

Versione: Windows 7 e versioni successive di Windows

Intestazione: Devpkey.h (include Devpkey.h)

Vedere anche

ID contenitore

SetupDiGetDeviceProperty