Freigeben über

DEVPKEY_Device_BaseContainerId

  • Artikel

Die DEVPKEY_Device_BaseContainerId-Geräteeigenschaft stellt den GUID-Wert des Basiscontainerbezeichners (ID) dar. Der PnP-Manager (Windows Plug & Play) weist diesen Wert dem Geräteknoten (devnode) zu.

attribute Wert
Eigenschaftenschlüssel DEVPKEY_Device_BaseContainerId
Eigenschaftsdatentypbezeichner DEVPROP_TYPE_GUID
Eigenschaftenzugriff Schreibgeschützter Zugriff durch Installationsanwendungen und Installationsprogramme.
Entsprechender SPDRP_Xxx-Bezeichner SPDRP_BASE_CONTAINERID
Lokalisierte? Nein

Bemerkungen

Der PnP-Manager bestimmt die Container-ID für einen Devnode mit einer der folgenden Methoden:

  • Ein Bustreiber stellt eine Container-ID bereit.

    Wenn der PnP-Manager einem Devnode eine Container-ID zuweist, überprüft er zunächst, ob der Bustreiber des Devnodes eine Container-ID bereitstellen kann. Bustreiber stellen eine Container-ID über eine IRP_MN_QUERY_ID-Abfrageanforderung bereit, wobei das Feld Parameters.QueryId.IdType auf BusQueryContainerID festgelegt ist.

  • Der PnP-Manager generiert mithilfe der Wechselmedienfunktion eine Container-ID.

    Wenn ein Bustreiber keine Container-ID für einen Devnode bereitstellen kann, den er aufzählt, verwendet der PnP-Manager die Wechselmedienfunktion, um eine Container-ID für alle Devnodes zu generieren, die für das Gerät aufgelistet sind. Der Bustreiber meldet diese Gerätefunktion als Reaktion auf eine IRP_MN_QUERY_CAPABILITIES-Anforderung .

  • Der PnP-Manager generiert mithilfe einer Außerkraftsetzung der Wechselmedienfunktion eine Container-ID.

    Obwohl der Überschreibungsmechanismus den Wert der Wechselmedienfunktion nicht ändert, erzwingt der PnP-Manager, die Außerkraftsetzungseinstellung und nicht den Wert der Wechselmedienfunktion zu verwenden, wenn Container-IDs für Geräte generiert werden.

Weitere Informationen zu diesen Methoden finden Sie unter Generieren von Container-IDs.

Unabhängig davon, wie der Container-ID-Wert abgerufen wird, weist der PnP-Manager den Wert der DEVPKEY_Device_BaseContainerId-Eigenschaft des Devnodes zu.

Die DEVPKEY_Device_BaseContainerId-Eigenschaft kann verwendet werden, um die Gruppierung eines neuen Devnodes mit anderen Devnodes zu erzwingen, die im System vorhanden sind. Dadurch können Sie den neuen Devnode als übergeordnete (oder basisbasierte) Container-ID für andere verwandte Devnodes verwenden. Dazu müssen Sie zunächst die DEVPKEY_Device_BaseContainerID GUID des vorhandenen Devnodes abrufen. Anschließend müssen Sie die Container-ID-GUID des neuen Devnodes als Reaktion auf eine IRP_MN_QUERY_ID Abfrageanforderung zurückgeben, die das Feld Parameters.QueryId.IdType auf BusQueryContainerID festgelegt hat.

Hinweis

Der Wert, der von einer Abfrage der eigenschaften DEVPKEY_Device_BaseContainerId oder DEVPKEY_Device_ContainerId zurückgegeben wird, kann für denselben Devnode unterschiedlich sein.

Hinweis

Verwenden Sie die eigenschaft DEVPKEY_Device_BaseContainerId nicht, um Gerätecontainergruppierungen im System zu rekonstruieren. Verwenden Sie stattdessen die eigenschaft DEVPKEY_Device_ContainerId .

Weitere Informationen zu Container-IDs finden Sie unter Container-IDs.

Anforderungen

Version: Windows 7 und höhere Versionen von Windows

Header: Devpkey.h (devpkey.h einschließen)

Weitere Informationen

Container-IDs

DEVPKEY_Device_ContainerId

SetupDiGetDeviceProperty