DEVPKEY_Device_ContainerId

A propriedade DEVPKEY_Device_ContainerId dispositivo é usada pelo gestor Plug and Play (PnP) para agrupar um ou mais nós de dispositivo (devnodes) num contentor de dispositivo que representa uma instância de um dispositivo físico.

Attribute Valor
Chave da propriedade DEVPKEY_Device_ContainerId
Identificador de tipo de propriedade DEVPROP_TYPE_GUID
Acesso à propriedade Acesso apenas de leitura por aplicações de instalação e instaladores
Localizado? No

Remarks

A partir do Windows 7, o gestor PnP utiliza o contentor do dispositivo e o seu identificador (ContainerID) para agrupar um ou mais devnodes que se originaram e pertencem a cada instância de um determinado dispositivo físico. O ContainerID de uma instância de dispositivo é referenciado através da propriedade DEVPKEY_Device_ContainerId dispositivo.

Quando agrupa todos os devnodes que originaram de uma instância de um único dispositivo em containers, obtém-se os seguintes resultados:

  • O sistema operativo pode determinar como a funcionalidade está relacionada entre devnodes que se originam de um dispositivo físico.

  • O utilizador ou aplicações são apresentados com uma visão centrada no dispositivo dos dispositivos, em vez da vista tradicional centrada na função.

O DEVPKEY_Device_ContainerId pode ser usado para determinar o agrupamento de devnodes de devnodes em containers de dispositivos num sistema. Para um determinado devnode, pode determinar todos os devnodes que pertencem ao mesmo contentor completando os seguintes passos:

  • Ligue para CM_Get_DevNode_Property ou SetupDiGetDeviceProperty para consultar DEVPKEY_Device_ContainerId pelo devnode indicado. O Windows devolve o valor GUID ContainerID para o contentor do dispositivo ao qual esse devnode pertence.

  • Enumere todos os devnodes no computador e consulte cada devnode para a sua DEVPKEY_Device_ContainerId. Cada valor ContainerId que corresponde ao valor ContainerId do devnode original faz parte do mesmo contentor.

Nota Todos os devnodes que pertencem a um contentor num dado tipo de barramento devem partilhar o mesmo valor ContainerID.

Para mais informações sobre ContainerIDs, consulte Container IDs.

Requirements

Versão: Windows 7 e versões posteriores do Windows

Cabeçalho: Devpkey.h (incluir Devpkey.h)

Ver também

IDs de contentores

SetupDiGetDeviceProperty