DEVPKEY_Device_BaseContainerId
The DEVPKEY_Device_BaseContainerId device property represents the GUID value of the base container identifier (ID). The Windows Plug and Play (PnP) manager assigns this value to the device node (devnode).
| Attribute | Value |
|---|---|
| Property key | DEVPKEY_Device_BaseContainerId |
| Property-data-type identifier | DEVPROP_TYPE_GUID |
| Property access | Read-only access by installation applications and installers. |
| Corresponding SPDRP_Xxx identifier | SPDRP_BASE_CONTAINERID |
| Localized? | No |
Remarks
The PnP manager determines the container ID for a devnode by using one of the following methods:
A bus driver provides a container ID.
When the PnP manager assigns a container ID to a devnode, it first checks whether the bus driver of the devnode can provide a container ID. Bus drivers provide a container ID through an IRP_MN_QUERY_ID query request with the Parameters.QueryId.IdType field set to BusQueryContainerID.
The PnP manager generates a container ID by using the removable device capability.
If a bus driver cannot provide a container ID for a devnode that it is enumerating, the PnP manager uses the removable device capability to generate a container ID for all devnodes that are enumerated for the device. The bus driver reports this device capability in response to an IRP_MN_QUERY_CAPABILITIES request.
The PnP manager generates a container ID by using an override of the removable device capability.
Although the override mechanism does not change the value of the removable device capability, it forces the PnP manager to use the override setting and not the value of the removable device capability when it generates container IDs for devices.
For more information about these methods, see How Container IDs are Generated.
Regardless of how the container ID value is obtained, the PnP manager assigns the value to the DEVPKEY_Device_BaseContainerId property of the devnode.
The DEVPKEY_Device_BaseContainerId property can be used to force the grouping of a new devnode with other devnodes that exists in the system. This lets you use the new devnode as the parent (or base) container ID for other related devnodes. To do this, you must first obtain the DEVPKEY_Device_BaseContainerID GUID of the existing devnode. Then, you must return the container ID GUID of the new devnode in response to an IRP_MN_QUERY_ID query request that has the Parameters.QueryId.IdType field set to BusQueryContainerID.
Note
The value that is returned by a query of the DEVPKEY_Device_BaseContainerId or DEVPKEY_Device_ContainerId properties can be different for the same devnode.
Note
Do not use the DEVPKEY_Device_BaseContainerId property to reconstruct device container groupings in the system. Use the DEVPKEY_Device_ContainerId property instead.
For more information about container IDs, see Container IDs.
Requirements
Version: Windows 7 and later versions of Windows
Header: Devpkey.h (include Devpkey.h)
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for