DEVPKEY_Device_BaseContainerId
A propriedade DEVPKEY_Device_BaseContainerId dispositivo representa o valor GUID do identificador de contêiner base (ID). O gerenciador do Windows Plug and Play (PnP) atribui esse valor ao nó do dispositivo (devnode).
| Atributo | Valor |
|---|---|
| Chave de propriedade | DEVPKEY_Device_BaseContainerId |
| Identificador de tipo de dados de propriedade | DEVPROP_TYPE_GUID |
| Acesso à propriedade | Acesso somente leitura por aplicativos de instalação e instaladores. |
| Identificador SPDRP_Xxx correspondente | SPDRP_BASE_CONTAINERID |
| Localizada? | Não |
Comentários
O gerenciador PnP determina a ID do contêiner para um devnode usando um dos seguintes métodos:
Um motorista de ônibus fornece uma ID de contêiner.
Quando o gerenciador PnP atribui uma ID de contêiner a um devnode, ele primeiro verifica se o driver de barramento do devnode pode fornecer uma ID de contêiner. Os motoristas de barramento fornecem uma ID de contêiner por meio de uma solicitação de consulta IRP_MN_QUERY_ID com o campo Parameters.QueryId.IdType definido como BusQueryContainerID.
O gerenciador PnP gera uma ID de contêiner usando a funcionalidade do dispositivo removível.
Se um driver de barramento não puder fornecer uma ID de contêiner para um devnode que ele está enumerando, o gerenciador de PnP usará a funcionalidade do dispositivo removível para gerar uma ID de contêiner para todos os devnodes que são enumerados para o dispositivo. O motorista do barramento relata essa funcionalidade de dispositivo em resposta a uma solicitação de IRP_MN_QUERY_CAPABILITIES .
O gerenciador PnP gera uma ID de contêiner usando uma substituição da funcionalidade do dispositivo removível.
Embora o mecanismo de substituição não altere o valor da funcionalidade do dispositivo removível, ele força o gerenciador PnP a usar a configuração de substituição e não o valor da funcionalidade do dispositivo removível quando gera IDs de contêiner para dispositivos.
Para obter mais informações sobre esses métodos, consulte Como as IDs de contêiner são geradas.
Independentemente de como o valor da ID do contêiner é obtido, o gerenciador PnP atribui o valor à propriedade DEVPKEY_Device_BaseContainerId do devnode.
A propriedade DEVPKEY_Device_BaseContainerId pode ser usada para forçar o agrupamento de um novo devnode com outros devnodes que existem no sistema. Isso permite que você use o novo devnode como a ID de contêiner pai (ou base) para outros devnodes relacionados. Para fazer isso, primeiro você deve obter o GUID DEVPKEY_Device_BaseContainerID do devnode existente. Em seguida, você deve retornar o GUID da ID do contêiner do novo devnode em resposta a uma solicitação de consulta IRP_MN_QUERY_ID que tenha o campo Parameters.QueryId.IdType definido como BusQueryContainerID.
Observação
O valor retornado por uma consulta das propriedades DEVPKEY_Device_BaseContainerId ou DEVPKEY_Device_ContainerId pode ser diferente para o mesmo devnode.
Observação
Não use a propriedade DEVPKEY_Device_BaseContainerId para reconstruir agrupamentos de contêineres de dispositivo no sistema. Em vez disso, use a propriedade DEVPKEY_Device_ContainerId .
Para obter mais informações sobre IDs de contêiner, consulte IDs de contêiner.
Requisitos
Versão: Windows 7 e versões posteriores do Windows
Cabeçalho: Devpkey.h (inclua Devpkey.h)