DEVPKEY_Device_ContainerId

A propriedade do dispositivo DEVPKEY_Device_ContainerId é usada pelo gerenciador de Plug and Play (PnP) para agrupar um ou mais nós de dispositivo (devnodes) em um contêiner de dispositivo que representa uma instância de um dispositivo físico.

Atributo Valor
Chave de propriedade DEVPKEY_Device_ContainerId
Identificador de tipo de dados de propriedade DEVPROP_TYPE_GUID
Acesso à propriedade Acesso somente leitura por aplicativos de instalação e instaladores
Localizada? Não

Comentários

A partir do Windows 7, o gerenciador de PnP usa o contêiner do dispositivo e seu identificador (ContainerID) para agrupar um ou mais devnodes originados e pertencem a cada instância de um determinado dispositivo físico. A ContainerID de uma instância de dispositivo é referenciada por meio da propriedade do dispositivo DEVPKEY_Device_ContainerId.

Ao agrupar todos os devnodes originados de uma instância de um único dispositivo em contêineres, você realiza os seguintes resultados:

  • O sistema operacional pode determinar como a funcionalidade está relacionada entre os devnodes originados de um dispositivo físico.

  • O usuário ou os aplicativos são apresentados com uma exibição centrada no dispositivo de dispositivos em vez da exibição tradicional centrada em função.

O DEVPKEY_Device_ContainerId pode ser usado para determinar o agrupamento de contêineres de dispositivos de devnodes em um sistema. Para um determinado devnode, você pode determinar todos os devnodes que pertencem ao mesmo contêiner concluindo as seguintes etapas:

  • Chame CM_Get_DevNode_Property ou SetupDiGetDeviceProperty para consultar DEVPKEY_Device_ContainerId para o devnode especificado. O Windows retorna o valor de GUID containerID para o contêiner do dispositivo ao qual esse devnode pertence.

  • Enumerar todos os devnodes no computador e consultar cada devnode para seu DEVPKEY_Device_ContainerId. Cada valor ContainerId que corresponde ao valor ContainerId do devnode original faz parte do mesmo contêiner.

Nota Todos os devnodes que pertencem a um contêiner em um determinado tipo de barramento devem compartilhar o mesmo valor ContainerID.

Para obter mais informações sobre ContainerIDs, consulte IDs de contêiner.

Requisitos

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

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

Confira também

IDs de contêiner

SetupDiGetDeviceProperty