DEVPKEY_Device_ContainerId

DEVPKEY_Device_ContainerId のデバイスプロパティは、物理デバイスのインスタンスを表すデバイスコンテナーにひとつ以上のデバイスノード (devnodes) をグループ化するために、プラグアンドプレイ (PnP) マネージャーによって使用されます。

属性 Value
プロパティ キー DEVPKEY_Device_ContainerId
プロパティデータ型識別子 DEVPROP_TYPE_GUID
「プロパティ アクセス」 インストールアプリケーションとインストーラーによる読み取り専用のアクセス。
ローカライズ済みでしょうか? いいえ

解説

Windows 7 以降、PnP マネージャーは、デバイスコンテナーとその識別子 (ContainerID) を使用して、特定の物理デバイスの各インスタンスから生成され、属しているひとつ以上の devnode をグループ化します。 デバイスインスタンスの ContainerID は、DEVPKEY_Device_ContainerId のデバイスプロパティを介して参照されます。

ひとつのデバイスのインスタンスから発生したすべての devnode をコンテナーにグループ化すると、次の結果が得られます。

  • オペレーティングシステムは、物理デバイスから生成された devnodes の間で機能がどのように関連しているかを判断できます。

  • ユーザーまたはアプリケーションには、従来の機能中心のビューではなく、デバイス中心のデバイスビューが表示されます。

DEVPKEY_Device_ContainerId を使用して、システム内の devnodes のデバイスコンテナーのグループ化を決定できます。 特定の devnode について、次の手順を実行して、同じコンテナーに属するすべての devnode を特定できます。

  • CM_Get_DevNode_Property または SetupDiGetDeviceProperty を呼び出して、指定された devnode の DEVPKEY_Device_ContainerId を照会します。 Windows は、該当する devnode が属するデバイスコンテナーの ContainerID GUID 値を返します。

  • コンピュータ上のすべての devnode を列挙し、各 devnode に DEVPKEY_Device_ContainerId を照会します。 元の devnode の ContainerId 値と一致するそれぞれの ContainerId 値は、同じコンテナーの一部です。

メモ 特定のバスの種類のコンテナーに属するすべての devnodes は、同じ ContainerID 値を共有する必要があります。

ContainerID の詳しい情報については、コンテナー ID を参照してください。

要件

バージョン:Windows 7 とそれ以降のバージョンの Windows

ヘッダー:Devpkey.h (Devpkey.h を含む)

関連項目

コンテナー ID

SetupDiGetDeviceProperty