DEVPKEY_Device_ContainerId

  • Article

La propriété d’appareil DEVPKEY_Device_ContainerId est utilisée par le gestionnaire de Plug-and-Play (PnP) pour regrouper un ou plusieurs nœuds d’appareil (devnodes) dans un conteneur d’appareil qui représente un instance d’un appareil physique.

Attribut Valeur
Clé de propriété DEVPKEY_Device_ContainerId
Identificateur de type de données de propriété DEVPROP_TYPE_GUID
Accès à la propriété Accès en lecture seule par les applications d’installation et les programmes d’installation
Localisée? Non

Notes

À compter de Windows 7, le gestionnaire PnP utilise le conteneur d’appareil et son identificateur (ContainerID) pour regrouper un ou plusieurs devnodes qui proviennent de et appartiennent à chaque instance d’un appareil physique particulier. Le ContainerID d’un instance d’appareil est référencé via la propriété d’appareil DEVPKEY_Device_ContainerId.

Lorsque vous regroupez tous les devnodes qui proviennent d’un instance d’un seul appareil dans des conteneurs, vous effectuez les résultats suivants :

  • Le système d’exploitation peut déterminer comment les fonctionnalités sont liées entre les devnodes qui proviennent d’un appareil physique.

  • L’utilisateur ou les applications bénéficient d’une vue centrée sur l’appareil des appareils au lieu de la vue traditionnelle centrée sur les fonctions.

Le DEVPKEY_Device_ContainerId peut être utilisé pour déterminer le regroupement de conteneurs d’appareils de devnodes dans un système. Pour un devnode donné, vous pouvez déterminer tous les devnodes qui appartiennent au même conteneur en effectuant les étapes suivantes :

  • Appelez CM_Get_DevNode_Property ou SetupDiGetDeviceProperty pour interroger DEVPKEY_Device_ContainerId pour le devnode donné. Windows retourne la valeur GUID ContainerID pour le conteneur d’appareil auquel appartient ce devnode.

  • Énumérez tous les devnodes sur l’ordinateur et interrogez chaque devnode pour connaître ses DEVPKEY_Device_ContainerId. Chaque valeur ContainerId qui correspond à la valeur ContainerId du devnode d’origine fait partie du même conteneur.

Note Tous les devnodes qui appartiennent à un conteneur sur un type de bus donné doivent partager la même valeur ContainerID.

Pour plus d’informations sur les ContainerIDs, consultez Id de conteneur.

Spécifications

Version : Windows 7 et versions ultérieures de Windows

En-tête : Devpkey.h (inclure Devpkey.h)

Voir aussi

ID des conteneurs

SetupDiGetDeviceProperty