DEVPKEY_Device_ContainerId

Właściwość urządzenia DEVPKEY_Device_ContainerId jest używana przez menedżera Plug and Play (PnP) do grupowania co najmniej jednego węzła urządzenia (devnodes) w kontenerze urządzenia, który reprezentuje wystąpienie urządzenia fizycznego.

Attribute Value
Klucz właściwości DEVPKEY_Device_ContainerId
Identyfikator typu danych właściwości DEVPROP_TYPE_GUID
Dostęp do właściwości Dostęp tylko do odczytu przez aplikacje instalacyjne i instalatory
Zlokalizowane? No

Remarks

Począwszy od Windows 7, menedżer PnP używa kontenera urządzenia i jego identyfikatora (ContainerID) do grupowania co najmniej jednego węzła deweloperskiego pochodzącego z i należeć do każdego wystąpienia określonego urządzenia fizycznego. Identyfikator ContainerID dla wystąpienia urządzenia jest przywołyny za pośrednictwem właściwości DEVPKEY_Device_ContainerId urządzenia.

Po zgrupowaniu wszystkich węzłów deweloperskich pochodzących z wystąpienia pojedynczego urządzenia w kontenery można uzyskać następujące wyniki:

  • System operacyjny może określić, jak funkcjonalność jest powiązana między węzłami deweloperskimi pochodzącymi z urządzenia fizycznego.

  • Użytkownik lub aplikacje są prezentowane z widokiem urządzenia skoncentrowanym na urządzeniach zamiast tradycyjnego widoku skoncentrowanego na funkcjach.

Za pomocą DEVPKEY_Device_ContainerId można określić grupowanie kontenerów urządzeń w systemach. Dla danego węzła devnode można określić wszystkie węzły devnode, które należą do tego samego kontenera, wykonując następujące czynności:

  • Wywołaj CM_Get_DevNode_Property lub SetupDiGetDeviceProperty , aby wysłać zapytanie DEVPKEY_Device_ContainerId dla danego węzła devnode. Windows zwraca wartość identyfikatora GUID identyfikatora GUID kontenera urządzenia, do którego należy ten węzeł deweloperski.

  • Wyliczanie wszystkich węzłów devnode na komputerze i wykonywanie zapytań względem każdego węzła deweloperskiego dla jego DEVPKEY_Device_ContainerId. Każda wartość ContainerId zgodna z wartością ContainerId oryginalnego węzła devnode jest częścią tego samego kontenera.

Uwaga Wszystkie węzły devnode należące do kontenera w danym typie magistrali muszą współdzielić tę samą wartość ContainerID.

Aby uzyskać więcej informacji na temat identyfikatorów kontenerów, zobacz Identyfikatory kontenerów.

Requirements

Wersja: Windows 7 i nowsze wersje Windows

Nagłówek: Devpkey.h (include Devpkey.h)

Informacje dodatkowe

Identyfikatory kontenerów

SetupDiGetDeviceProperty