DEVPKEY_Device_ContainerId

Свойство устройства DEVPKEY_Device_ContainerId используется диспетчером Plug and Play (PnP) для группировки одного или нескольких узлов устройств (devnodes) в контейнер устройства, представляющий экземпляр физического устройства.

Attribute Value
Ключ свойства DEVPKEY_Device_ContainerId
Идентификатор типа property-data DEVPROP_TYPE_GUID
Доступ к свойствам Доступ только для чтения по приложениям и установщикам установки
Локализованные? No

Remarks

Начиная с Windows 7 диспетчер PnP использует контейнер устройства и его идентификатор (ContainerID) для группировки одного или нескольких devnodes, исходящих из каждого экземпляра конкретного физического устройства. На контейнер для экземпляра устройства ссылается свойство устройства DEVPKEY_Device_ContainerId.

При группировке всех devnodes, полученных из экземпляра одного устройства в контейнеры, выполните следующие результаты:

  • Операционная система может определить, как функциональные возможности связаны между devnodes , поступающими из физического устройства.

  • Пользователь или приложения представлены с представлением устройств, ориентированным на устройства, а не традиционным представлением, ориентированным на функцию.

DEVPKEY_Device_ContainerId можно использовать для определения группирования контейнеров устройств devnodes в системе. Для данного devnode можно определить все devnodes, принадлежащие одному контейнеру, выполнив следующие действия:

  • Вызовите CM_Get_DevNode_Property или SetupDiGetDeviceProperty, чтобы запросить DEVPKEY_Device_ContainerId для заданного devnode. Windows возвращает значение GUID ContainerID для контейнера устройства, которому принадлежит этот devnode.

  • Перечисляйте все devnodes на компьютере и запрашивайте каждый devnode для его DEVPKEY_Device_ContainerId. Каждое значение ContainerId, соответствующее значению ContainerId исходного devnode, является частью одного контейнера.

Примечание Все devnodes , принадлежащие контейнеру в заданном типе шины, должны совместно использовать одно и то же значение ContainerID.

Дополнительные сведения о идентификаторах контейнеров см. в разделе "Идентификаторы контейнеров".

Requirements

Версия: Windows 7 и более поздние версии Windows

Заголовок: Devpkey.h (включить Devpkey.h)

См. также

Идентификаторы контейнеров

SetupDiGetDeviceProperty