DEVPKEY_Device_BaseContainerId
La propriété d’appareil DEVPKEY_Device_BaseContainerId représente la valeur GUID de l’identificateur de conteneur de base (ID). Le gestionnaire de Plug-and-Play Windows (PnP) attribue cette valeur au nœud d’appareil (devnode).
| Attribut | Valeur |
|---|---|
| Clé de propriété | DEVPKEY_Device_BaseContainerId |
| 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. |
| Identificateur SPDRP_Xxx correspondant | SPDRP_BASE_CONTAINERID |
| Localisée? | Non |
Notes
Le gestionnaire PnP détermine l’ID de conteneur d’un devnode à l’aide de l’une des méthodes suivantes :
Un pilote de bus fournit un ID de conteneur.
Lorsque le gestionnaire PnP affecte un ID de conteneur à un devnode, il vérifie d’abord si le pilote de bus du devnode peut fournir un ID de conteneur. Les pilotes bus fournissent un ID de conteneur via une requête IRP_MN_QUERY_ID avec le champ Parameters.QueryId.IdType défini sur BusQueryContainerID.
Le gestionnaire PnP génère un ID de conteneur à l’aide de la fonctionnalité d’appareil amovible.
Si un pilote de bus ne peut pas fournir d’ID de conteneur pour un devnode qu’il énumére, le gestionnaire PnP utilise la fonctionnalité d’appareil amovible pour générer un ID de conteneur pour tous les devnodes énumérés pour l’appareil. Le pilote de bus signale cette fonctionnalité d’appareil en réponse à une demande de IRP_MN_QUERY_CAPABILITIES .
Le gestionnaire PnP génère un ID de conteneur à l’aide d’un remplacement de la fonctionnalité d’appareil amovible.
Bien que le mécanisme de remplacement ne modifie pas la valeur de la fonctionnalité d’appareil amovible, il force le gestionnaire PnP à utiliser le paramètre de remplacement et non la valeur de la fonctionnalité d’appareil amovible lorsqu’il génère des ID de conteneur pour les appareils.
Pour plus d’informations sur ces méthodes, consultez Comment les ID de conteneur sont générés.
Quelle que soit la façon dont la valeur de l’ID de conteneur est obtenue, le gestionnaire PnP affecte la valeur à la propriété DEVPKEY_Device_BaseContainerId du devnode.
La propriété DEVPKEY_Device_BaseContainerId peut être utilisée pour forcer le regroupement d’un nouveau devnode avec d’autres devnodes qui existent dans le système. Cela vous permet d’utiliser le nouveau devnode comme ID de conteneur parent (ou de base) pour d’autres devnodes associés. Pour ce faire, vous devez d’abord obtenir le DEVPKEY_Device_BaseContainerID GUID du devnode existant. Ensuite, vous devez retourner le GUID d’ID de conteneur du nouveau devnode en réponse à une requête IRP_MN_QUERY_ID dont le champ Parameters.QueryId.IdType est défini sur BusQueryContainerID.
Notes
La valeur retournée par une requête des propriétés DEVPKEY_Device_BaseContainerId ou DEVPKEY_Device_ContainerId peut être différente pour le même devnode.
Notes
N’utilisez pas la propriété DEVPKEY_Device_BaseContainerId pour reconstruire les regroupements de conteneurs d’appareils dans le système. Utilisez plutôt la propriété DEVPKEY_Device_ContainerId .
Pour plus d’informations sur les ID de conteneur, consultez ID de conteneur.
Spécifications
Version : Windows 7 et versions ultérieures de Windows
En-tête : Devpkey.h (inclure Devpkey.h)