DEVPKEY_Device_ContainerId

A propriedade DEVPKEY_Device_ContainerId dispositivo é 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.

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

Remarks

Começando com Windows 7, o gerenciador 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 originários 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 do modo de exibição tradicional centrado 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. Windows retorna o valor guid containerID do contêiner do dispositivo ao qual esse devnode pertence.

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

Observação 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.

Requirements

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

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

Consulte também

IDs de contêiner

SetupDiGetDeviceProperty