Свойства сведений об устройстве

  • Статья

Каждое устройство имеет связанные свойства DeviceInformation , которые можно использовать при необходимости определенных сведений или при создании селектора устройств. Фильтр расширенного синтаксиса запросов (AQS) можно использовать для указания этих свойств и ограничения перечисленных устройств указанными чертами. Эти свойства также можно использовать для указания сведений, возвращаемых для каждого устройства. Это позволяет указать сведения об устройстве, возвращаемые приложению.

Важные API

Дополнительные сведения об использовании свойств DeviceInformation в селекторе устройств см. в разделе "Создание селектора устройства". В этом разделе показано, как запрашивать свойства информации и описывать некоторые общие свойства.

Объект DeviceInformation состоит из удостоверения (DeviceInformation.Id), типа (DeviceInformation.Kind) и контейнера свойств (DeviceInformation.Properties). Все остальные свойства объекта DeviceInformation являются производными от контейнера свойств Свойства . Например, имя является производным от System.ItemNameDisplay. Это означает, что контейнер свойств всегда содержит сведения, необходимые для определения других свойств.

Запрос свойств

Объект DeviceInformation имеет некоторые основные свойства, такие как Id и Kind, но большинство свойств хранятся в контейнере свойств в разделе "Свойства". Из-за этого контейнер свойств содержит свойства, используемые для источника свойств из контейнера свойств. Например, используйте System.ItemNameDisplay для источника свойства Name . Это случай общего и известного свойства, которое имеет понятное имя. Windows предоставляет несколько из этих понятных имен, чтобы упростить запросы к свойствам.

При запросе свойств вы не ограничиваетесь общими свойствами с понятными именами. Можно указать базовый идентификатор GUID и идентификатор свойства (PID), чтобы запросить любое доступное свойство, даже настраиваемые свойства, предоставляемые отдельным устройством или драйвером. Формат указания настраиваемого свойства — "{GUID} PID". Например: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".

Примечание.

Список идентификаторов GUID свойств можно найти в файле заголовка ключа свойства устройства драйвера устройства.

Некоторые свойства являются общими для всех объектов DeviceInformationKind , но большинство из них уникальны для определенного типа. В следующих разделах перечислены некоторые распространенные свойства, отсортированные по отдельным Устройствам DeviceInformationKind. Дополнительные сведения о том, как различные виды связаны друг с другом, см. в разделе DeviceInformationKind.

Свойства DeviceInterface

DeviceInterface — это стандартный и наиболее распространенный объект DeviceInformationKind , используемый в сценариях приложений. Это тип объекта, который следует использовать, если API устройства не указывает на другой конкретный объект DeviceInformationKind.

Имя. Тип Описание
System.Devices.ContainerId GUID Удостоверение DeviceInformationKind.DeviceContainer, содержащее устройство, содержащее устройство, содержащее устройство DeviceInterface. Это значение можно передать в CreateFromIdAsync вместе с DeviceInformationKind.DeviceContainer, чтобы найти соответствующий контейнер.
System.Devices.InterfaceClassGuid GUID Идентификатор GUID класса интерфейса, который представляет этот интерфейс.
System.Devices.DeviceInstanceId Строка Удостоверение родительского устройства DeviceInformationKind.Device. Это значение можно передать в CreateFromIdAsync вместе с DeviceInformationKind.Device, чтобы найти соответствующее устройство.
System.Devices.InterfaceEnabled Логический Указывает, включен ли интерфейс. DeviceInformation.IsEnabled является производным от этого свойства.
System.Devices.GlyphIcon Строка Путь значка для глифа.
System.Devices.IsDefault Логический Указывает, является ли это устройством по умолчанию для System.Devices.InterfaceClassGuid. Это в основном используется для принтеров. Это не работает для звука, так как имеется несколько значений по умолчанию. Используйте GetDefaultAudioRenderId или GetDefaultAudioCaptureId , чтобы получить звук по умолчанию.
System.Devices.Icon Строка Путь к значку.
System.ItemNameDisplay Строка Лучшее отображаемое имя объекта устройства.

 

Свойства устройства

Имя. Тип Описание
System.Devices.ClassGuid GUID Класс устройства, используемый во время установки устройства. Дополнительные сведения см. в разделе "Классы установки устройств".
System.Devices.CompatibleIds String[] Совместимые идентификаторы устройства. Они используются, когда Windows определяет лучший драйвер для установки на устройстве. Дополнительные сведения см. в разделе "Совместимый идентификатор".
System.Devices.ContainerId GUID Удостоверение DeviceInformationKind.DeviceContainer, включающее это устройство. Это значение можно передать в CreateFromIdAsync вместе с DeviceInformationKind.DeviceContainer, чтобы найти соответствующий контейнер.
System.Devices.DeviceCapabilities UInt32 Побитовое или флаги CM_DEVCAP_X возможностей, определенных в CfgMgr32.h. Дополнительные сведения см. в DEVPKEY_Device_Capabilities.
System.Devices.DeviceHasProblem Логический Устройство в настоящее время имеет проблему и, скорее всего, не работает правильно. Это может быть связано с устаревшим, отсутствующим или недопустимым драйвером.
System.Devices.DeviceInstanceId Строка Удостоверение устройства. Это также значение DeviceInformation.Id.
System.Devices.DeviceManufacturer Строка Производитель устройства.
System.Devices.HardwareIds String[] Идентификаторы оборудования устройства. Windows использует эти идентификаторы при определении лучшего драйвера для установки. Поставщики устройств могут использовать это свойство для идентификации устройства из приложения. Дополнительные сведения см. в разделе "Идентификатор оборудования".
System.Devices.Parent Строка DeviceInformation.Id родительского устройства. Это родительский элемент подключения, а не родительский элемент DeviceContainer .
System.Devices.Present Логический Указывает, присутствует ли устройство в настоящее время и доступно.
System.ItemNameDisplay Строка Лучшее отображаемое имя для этого объекта устройства. В этом случае это не обязательно лучшее имя для пользователей. Более вероятный кандидат на понятное имя можно найти, ссылаясь на System.ItemNameDisplay связанного устройства DeviceContainer или DeviceInterface.

 

Свойства DeviceContainer

Имя. Тип Описание
System.Devices.Category String[] Список описаний категорий, к которой принадлежит устройство. Этот список предоставляется как сингулярные категории. Например, "Display", "Телефон" или "Звуковое устройство".
System.Devices.CategoryIds String[] Содержит список категорий, к которой принадлежит это устройство. Например, Audio.Headphone, Display.Monitor или Input.Gaming.
System.Devices.CategoryPlural String[] Список описаний категорий, к которой принадлежит устройство. Этот список предоставляется в виде категорий множественного числа. Например, "Отображает", "Телефон" или "Звуковые устройства".
System.Devices.CompatibleIds String[] Коллекция совместимых идентификаторов для всех дочерних объектов DeviceInformationKind.Device .
System.Devices. Подключение Логический Указывает, подключено ли устройство к системе.
System.Devices.GlyphIcon Строка Путь значка для глифа.
System.Devices.HardwareIds String[] Коллекция идентификаторов оборудования для всех дочерних объектов DeviceInformationKind.Device .
System.Devices.Icon Строка Путь к значку.
System.Devices.LocalMachine Логический Значение true, если этот deviceContainer представляет саму систему, значение false, если устройство является внешним для системы.
System.Devices.Manufacturer Строка Производитель устройства.
System.Devices.ModelName Строка Имя модели контейнера устройства.
System.Devices.Paired Логический Указывает, являются ли какие-либо дочерние объекты DeviceInformationKind.Device беспроводными или сетевыми устройствами, которые в настоящее время связаны с системой.
System.ItemNameDisplay Строка Лучшее отображаемое имя для этого устройства.

 

Свойства DeviceInterfaceClass

Имя. Тип Описание
System.ItemNameDisplay Строка Лучшее отображаемое имя для этого устройства.

 

Свойства DevicePanel

Имя. Тип Описание
System.Devices.Panel.PanelId Строка Идентификатор объекта DevicePanel .
System.Devices.Panel.PanelGroup Строка Идентификатор родительской панелиGroup.

Свойства AssociationEndpoint

Имя. Тип Описание
System.Devices.Aep.AepId Строка Удостоверение этого устройства. Это также значение DeviceInformation.Id.
System.Devices.Aep.CanPair Логический Указывает, можно ли связать устройство с системой или нет. DeviceInformationPairing.CanPair является производным от этого свойства.
System.Devices.Aep.Category String[] Категории, к которым относится устройство. Например, принтер или камера.
System.Devices.Aep.ContainerId GUID Идентификатор родительского объекта AssociationEndpointContainer .
System.Devices.Aep.DeviceAddress Строка Адрес устройства. Если устройство является сетевым устройством, это IP-адрес.
System.Devices.Aep.Is Подключение Логический Указывает, подключено ли устройство к системе.
System.Devices.Aep.IsPaired Логический Указывает, подключено ли устройство в данный момент. DeviceInformationPairing.IsPaired является производным от этого свойства.
System.Devices.Aep.IsPresent Логический Указывает, присутствует ли устройство, то есть устройство находится в режиме реального времени и обнаруживается по сетевому или беспроводному протоколу. После связывания устройства с системой устройство кэшируется. После этого устройство будет автоматически обнаружено при запросе объектов AssociationEndpoint . Из-за этого вы не можете полагаться только на обнаружение устройства с запросом, чтобы указать, подходит ли он в настоящее время. Именно поэтому это свойство важно.
System.Devices.Aep.Manufacturer Строка Производитель устройства.
System.Devices.Aep.ModelId GUID Идентификатор модели устройства.
System.Devices.Aep.ModelName Строка Имя модели устройства.
System.Devices.Aep.ProtocolId GUID Указывает протокол, используемый для обнаружения этого устройства AssocationEndpoint .
System.Devices.Aep.SignalStrength Int32 Сила сигнала устройства. Это свойство применимо только для некоторых протоколов.
System.ItemNameDisplay Строка Лучшее отображаемое имя устройства.

 

Свойства AssociationEndpointContainer

Имя. Тип Описание
System.Devices.AepContainer.Categories String[] Категории, к которым относится устройство. Например, принтер или камера.
System.Devices.AepContainer.Children String[] Коллекция идентификаторов для объектов AssocationEndpoint , входящих в этот контейнер.
System.Devices.AepContainer.CanPair Логический Указывает, можно ли связать одно из дочерних устройств AssociationEndpoint с системой или нет. DeviceInformationPairing.CanPair является производным от этого свойства.
System.Devices.AepContainer.ContainerId GUID Удостоверение этого устройства. Это также значение DeviceInformation.Id, но в форме GUID.
System.Devices.AepContainer.IsPaired Логический Указывает, подключено ли одно из дочерних устройств AssociationEndpoint . DeviceInformationPairing.IsPaired является производным от этого свойства.
System.Devices.AepContainer.IsPresent Логический Указывает, присутствует ли одно из дочерних устройств AssociationEndpoint , то есть устройство находится в режиме реального времени и обнаруживается по сетевому или беспроводному протоколу. После связывания устройства с системой устройство кэшируется. После этого устройство будет автоматически обнаружено при запросе объектов AssociationEndpoint . Из-за этого вы не можете полагаться только на обнаружение устройства с запросом, чтобы указать, подходит ли он в настоящее время. Именно поэтому это свойство важно.
System.Devices.AepContainer.Manufacturer Строка Производитель устройства.
System.Devices.AepContainer.ModelIds String[] Список идентификаторов модели для устройства. Каждая модель представляет собой GUID в строковой форме.
System.Devices.AepContainer.ModelName Строка Имя модели устройства.
System.Devices.AepContainer.ProtocolIds GUID[] Список идентификаторов протокола, которые способствовали созданию этого объекта AssociationEndpointContainer . Помните, что устройство AssociationEndpointContainer создается путем сбора всех устройств AssociationEndpoint , обнаруженных по разным протоколам для одного физического устройства.
System.Devices.AepContainer.SupportedUriSchemes String[] Список схем URI приведения, поддерживаемых этим устройством.
System.Devices.AepContainer.SupportsAudio Логический Указывает, поддерживает ли это устройство приведение звука.
System.Devices.AepContainer.SupportsImages Логический Указывает, поддерживает ли это устройство приведение изображений.
System.Devices.AepContainer.SupportsVideo Логический Указывает, поддерживает ли это устройство приведение видео.
System.ItemNameDisplay Строка Лучшее отображаемое имя устройства.

 

Свойства AssociationEndpointService

Имя. Тип Описание
System.Devices.AepService.AepId Строка Идентификатор родительского объекта AssociationEndpoint .
System.Devices.AepService.ContainerId GUID Идентификатор родительского объекта AssociationEndpointContainer .
System.Devices.AepService.ParentAepIsPaired Логический Указывает, связан ли родительский объект AssociationEndpoint с системой.
System.Devices.AepService.ProtocolId GUID Удостоверение протокола, используемого для обнаружения этого устройства.
System.Devices.AepService.ServiceClassId GUID Удостоверение службы, представленной этим устройством.
System.Devices.AepService.ServiceId Строка Удостоверение этой службы. Это также значение DeviceInformation.Id.
System.ItemNameDisplay Строка Лучшее отображаемое имя службы.