Condividi tramite


DEVPKEY_Device_ContainerId

La proprietà del dispositivo DEVPKEY_Device_ContainerId viene usata dal gestore 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.

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

Osservazioni

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

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

  • Il sistema operativo può determinare il modo in cui le funzionalità sono correlate tra gli elementi devnodes che hanno origine da un dispositivo fisico.

  • L'utente o le applicazioni vengono presentati con una visualizzazione incentrata sui dispositivi invece della visualizzazione tradizionale incentrata sulle funzioni.

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

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

  • Enumerare tutti gli elementi devnodes nel computer ed eseguire query su ogni 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.

Requisiti

Versione: Windows 7 e versioni successive di Windows

Intestazione: Devpkey.h (include Devpkey.h)

Vedi anche

ID dei contenitori

SetupDiGetDeviceProperty