DEVPKEY_Device_ContainerId

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

attribute Значение
Ключ свойства DEVPKEY_Device_ContainerId
Идентификатор типа данных свойства DEVPROP_TYPE_GUID
Доступ к свойству Доступ только для чтения с помощью установочных приложений и установщиков
Локализованные? Нет

Remarks

Начиная с Windows 7, диспетчер PnP использует контейнер устройства и его идентификатор (ContainerID) для группировки одного или нескольких devnodes , которые были получены из и принадлежат каждому экземпляру конкретного физического устройства. Ссылка на ContainerID для экземпляра устройства осуществляется через свойство устройства 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.

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

Требования

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

Заголовок: Devpkey.h (включая Devpkey.h)

См. также раздел

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

SetupDiGetDeviceProperty