DEVPKEY_Device_BaseContainerId
La proprietà del dispositivo DEVPKEY_Device_BaseContainerId rappresenta il valore GUID dell'identificatore del contenitore di base (ID). Il gestore di Windows Plug and Play (PnP) assegna questo valore al nodo del dispositivo (devnode).
| Attributo | Valore |
|---|---|
| Chiave della proprietà | DEVPKEY_Device_BaseContainerId |
| Identificatore property-data-type | DEVPROP_TYPE_GUID |
| Accesso a proprietà | Accesso di sola lettura da parte di applicazioni di installazione e programmi di installazione. |
| Identificatore SPDRP_Xxx corrispondente | SPDRP_BASE_CONTAINERID |
| Localizzata? | No |
Osservazioni
Il gestore PnP determina l'ID contenitore per un devnode usando uno dei metodi seguenti:
Un driver del bus fornisce un ID contenitore.
Quando il gestore PnP assegna un ID contenitore a un devnode, verifica innanzitutto se il driver del bus del devnode può fornire un ID contenitore. I driver del bus forniscono un ID contenitore tramite una richiesta di query IRP_MN_QUERY_ID con il campo Parameters.QueryId.IdType impostato su BusQueryContainerID.
La gestione PnP genera un ID contenitore usando la funzionalità di dispositivo rimovibile.
Se un driver del bus non può fornire un ID contenitore per un devnode che sta enumerando, il gestore PnP usa la funzionalità di dispositivo rimovibile per generare un ID contenitore per tutti gli identificatori di sviluppo enumerati per il dispositivo. Il driver del bus segnala questa funzionalità del dispositivo in risposta a una richiesta di IRP_MN_QUERY_CAPABILITIES .
La gestione PnP genera un ID contenitore usando un override della funzionalità di dispositivo rimovibile.
Anche se il meccanismo di override non modifica il valore della funzionalità di dispositivo rimovibile, forza il gestore PnP a usare l'impostazione di override e non il valore della funzionalità di dispositivo rimovibile quando genera ID contenitore per i dispositivi.
Per altre informazioni su questi metodi, vedere Come vengono generati gli ID contenitore.
Indipendentemente dal modo in cui viene ottenuto il valore dell'ID contenitore, il gestore PnP assegna il valore alla proprietà DEVPKEY_Device_BaseContainerId del nodo devnode.
La proprietà DEVPKEY_Device_BaseContainerId può essere usata per forzare il raggruppamento di un nuovo devnode con altri devnodes presenti nel sistema. In questo modo è possibile usare il nuovo devnode come ID contenitore padre (o di base) per altri devnodes correlati. A tale scopo, è prima necessario ottenere il GUID DEVPKEY_Device_BaseContainerID del nodo devnode esistente. È quindi necessario restituire il GUID DELL'ID contenitore del nuovo devnode in risposta a una richiesta di query IRP_MN_QUERY_ID con il campo Parameters.QueryId.IdType impostato su BusQueryContainerID.
Nota
Il valore restituito da una query delle proprietà DEVPKEY_Device_BaseContainerId o DEVPKEY_Device_ContainerId può essere diverso per lo stesso devnode.
Nota
Non usare la proprietà DEVPKEY_Device_BaseContainerId per ricostruire i raggruppamenti di contenitori di dispositivi nel sistema. Utilizzare invece la proprietà DEVPKEY_Device_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)