Propriedades de informações do dispositivo
Cada dispositivo tem propriedades DeviceInformation associadas que você pode usar quando precisar de informações específicas ou quando estiver criando um seletor de dispositivo. Um filtro AQS (Advanced Query Syntax) pode ser usado para especificar essas propriedades e limitar os dispositivos enumerados com as características especificadas. Você também pode usar essas propriedades para indicar quais informações deseja que sejam retornadas para cada dispositivo. Isso permite que você especifique as informações do dispositivo que são retornadas ao seu aplicativo.
APIs importantes
Para obter mais informações sobre como usar as propriedades DeviceInformation no seletor de dispositivo, consulte Criar um seletor de dispositivo. Este tópico mostra como solicitar propriedades de informações e descreve algumas propriedades comuns.
Um objeto DeviceInformation é composto por uma identidade (DeviceInformation.Id), um tipo (DeviceInformation.Kind) e um recipiente de propriedades (DeviceInformation.Properties). Todas as outras propriedades de um objeto DeviceInformation são derivadas do recipiente de propriedades Properties. Por exemplo, Name é derivado de System.ItemNameDisplay. Isso significa que o recipiente de propriedades sempre contém as informações necessárias para determinar as outras propriedades.
Solicitar propriedades
Um objeto DeviceInformation tem algumas propriedades básicas, como Id e Kind, mas a maioria das propriedades é armazenada em um recipiente de propriedades em Properties. Devido a isso, o recipiente de propriedades contém as propriedades usadas para originar as propriedades fora do recipiente de propriedades. Por exemplo, use System.ItemNameDisplay para originar a propriedade Name. Este é um caso de uma propriedade comum e bem conhecida que tem um nome amigável. O Windows fornece vários desses nomes amigáveis para facilitar a consulta de propriedades.
Quando você está solicitando propriedades, você não está limitado às propriedades comuns com nomes amigáveis. Você pode especificar o GUID subjacente e o ID da propriedade (PID) para solicitar qualquer propriedade disponível, até mesmo propriedades personalizadas fornecidas por um dispositivo ou driver individual. O formato para especificar uma propriedade personalizada é "{GUID} PID". Por exemplo: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".
Observação
Você pode encontrar a lista de GUIDs de propriedade no arquivo de cabeçalho de chave de propriedade do dispositivo do driver de dispositivo.
Algumas propriedades são comuns em todos os objetos DeviceInformationKind, mas a maioria é exclusiva de um tipo específico. As seções a seguir listam algumas propriedades comuns classificadas pelo DeviceInformationKind individual. Para obter mais informações sobre como os diferentes tipos se relacionam entre si, consulte DeviceInformationKind.
Propriedades DeviceInterface
DeviceInterface é o objeto DeviceInformationKind padrão e mais comum usado em cenários de aplicativo. Esse é o tipo de objeto que você deve usar, a menos que a API do dispositivo indique um DeviceInformationKind específico diferente.
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.ContainerId | GUID | Identidade do DeviceInformationKind.DeviceContainer que contém o dispositivo que contém este DeviceInterface. Você pode passar esse valor para CreateFromIdAsync junto com DeviceInformationKind.DeviceContainer para localizar o contêiner apropriado. |
| System.Devices.InterfaceClassGuid | GUID | O GUID da classe de interface que essa interface representa. |
| System.Devices.DeviceInstanceId | String | Identidade do DeviceInformationKind.Device pai. Você pode passar esse valor para CreateFromIdAsync junto com DeviceInformationKind.Device para localizar o dispositivo apropriado. |
| System.Devices.InterfaceEnabled | Booliano | Indica se a interface está habilitada. DeviceInformation.IsEnabled é derivado dessa propriedade. |
| System.Devices.GlyphIcon | String | Caminho do ícone para o glifo. |
| System.Devices.IsDefault | Booliano | Indica se este é o dispositivo padrão para o System.Devices.InterfaceClassGuid. Isso é usado principalmente para impressoras. Isso não funciona para áudio, pois há vários padrões de áudio. Use GetDefaultAudioRenderId ou GetDefaultAudioCaptureId para obter padrões de áudio. |
| System.Devices.Icon | String | Caminho do ícone. |
| System.ItemNameDisplay | String | O melhor nome de exibição para o objeto de dispositivo. |
Propriedades do dispositivo
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.ClassGuid | GUID | Classe de dispositivo usada durante a instalação do dispositivo. Para obter mais informações, confira Classes de configuração de dispositivo. |
| System.Devices.CompatibleIds | String[] | Os ids compatíveis do dispositivo. Eles são usados quando o Windows está determinando o melhor driver para instalar no dispositivo. Para obter mais informações, consulte ID compatível. |
| System.Devices.ContainerId | GUID | Identidade do DeviceInformationKind.DeviceContainer que inclui este dispositivo. Você pode passar esse valor para CreateFromIdAsync junto com DeviceInformationKind.DeviceContainer para localizar o contêiner apropriado. |
| System.Devices.DeviceCapabilities | UInt32 | Um OR bit a bit dos sinalizadores de recursos CM_DEVCAP_X definidos em CfgMgr32.h. Para obter mais informações, consulte DEVPKEY_Device_Capabilities. |
| System.Devices.DeviceHasProblem | Booliano | O dispositivo atualmente tem um problema e provavelmente não está funcionando corretamente. Isso pode ser devido a um driver desatualizado, ausente ou inválido. |
| System.Devices.DeviceInstanceId | String | A identidade do dispositivo. Esse também é o valor de DeviceInformation.Id. |
| System.Devices.DeviceManufacturer | String | O fabricante do dispositivo. |
| System.Devices.HardwareIds | String[] | Os ids de hardware do dispositivo. O Windows usa esses ids ao determinar o melhor driver a ser instalado. Os fornecedores de dispositivos podem usar essa propriedade para identificar seus dispositivos a partir de seus aplicativos. Para mais informações, consulte ID de hardware. |
| System.Devices.Parent | String | O DeviceInformation.Id do dispositivo pai. Este é o pai da conexão, não o pai do DeviceContainer. |
| System.Devices.Present | Booliano | Indica se o dispositivo está presente e disponível no momento. |
| System.ItemNameDisplay | String | O melhor nome de exibição para esse objeto de dispositivo. Neste caso, este não é necessariamente o melhor nome para os usuários. Um candidato mais provável para um nome amigável pode ser encontrado fazendo referência ao System.ItemNameDisplay do DeviceContainer ou DeviceInterface associado. |
Propriedades DeviceContainer
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.Category | String[] | Uma lista de descrições das categorias às quais o dispositivo pertence. Esta lista é fornecida como categorias singulares. Por exemplo, "Display", "Phone" ou "Audio device". |
| System.Devices.CategoryIds | String[] | Contém uma lista de categorias às quais este dispositivo pertence. Por exemplo, Audio.Headphone, Display.Monitor ou Input.Gaming. |
| System.Devices.CategoryPlural | String[] | Uma lista de descrições das categorias às quais o dispositivo pertence. Esta lista é fornecida como categorias plurais. Por exemplo, "Displays", "Phones" ou "Audio devices". |
| System.Devices.CompatibleIds | String[] | A coleção de ids compatíveis para todos os objetos filho DeviceInformationKind.Device. |
| System.Devices.Connected | Booliano | Indica se o dispositivo está conectado ao sistema no momento ou não. |
| System.Devices.GlyphIcon | String | Caminho do ícone para o glifo. |
| System.Devices.HardwareIds | String[] | A coleção de ids de hardware para todos os objetos filho DeviceInformationKind.Device. |
| System.Devices.Icon | String | Caminho do ícone. |
| System.Devices.LocalMachine | Booliano | True se esse DeviceContainer representar o próprio sistema, false se o dispositivo for externo ao sistema. |
| System.Devices.Manufacturer | String | O fabricante do dispositivo. |
| System.Devices.ModelName | String | Nome do modelo do contêiner do dispositivo. |
| System.Devices.Paired | Booliano | Indica se qualquer um dos objetos filho DeviceInformationKind.Device são dispositivos sem fio ou de rede que estão atualmente emparelhados com o sistema. |
| System.ItemNameDisplay | String | O melhor nome de exibição para esse dispositivo. |
Propriedades DeviceInterfaceClass
| Nome | Tipo | Descrição |
|---|---|---|
| System.ItemNameDisplay | String | O melhor nome de exibição para esse dispositivo. |
Propriedades DevicePanel
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.Panel.PanelId | String | O identificador do objeto DevicePanel. |
| System.Devices.Panel.PanelGroup | String | O identificador do PanelGroup pai. |
Propriedades AssociationEndpoint
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.Aep.AepId | String | Identidade deste dispositivo. Esse também é o valor de DeviceInformation.Id. |
| System.Devices.Aep.CanPair | Booliano | Indica se o dispositivo pode ser emparelhado com o sistema ou não. DeviceInformationPairing.CanPair é derivado dessa propriedade. |
| System.Devices.Aep.Category | String[] | As categorias das quais o dispositivo faz parte. Por exemplo, impressora ou câmera. |
| System.Devices.Aep.ContainerId | GUID | A id do objeto pai AssociationEndpointContainer. |
| System.Devices.Aep.DeviceAddress | String | O endereço do dispositivo. Se o dispositivo for um dispositivo de rede, este é o endereço IP. |
| System.Devices.Aep.IsConnected | Booliano | Indica se o dispositivo está conectado ao sistema no momento. |
| System.Devices.Aep.IsPaired | Booliano | Indica se o dispositivo está emparelhado no momento. DeviceInformationPairing.IsPaired é derivado dessa propriedade. |
| System.Devices.Aep.IsPresent | Booliano | Indica se o dispositivo está presente no momento, o que significa que o dispositivo está ativo e foi descoberto pela rede ou protocolo sem fio. Depois que um dispositivo é emparelhado com o sistema, ele é armazenado em cache. Depois disso, o dispositivo será descoberto automaticamente ao consultar objetos AssociationEndpoint. Por causa disso, você não pode confiar em apenas descobrir o dispositivo com uma consulta para indicar se ele é ou não utilizável no momento. É por isso que essa propriedade é importante. |
| System.Devices.Aep.Manufacturer | String | O fabricante do dispositivo. |
| System.Devices.Aep.ModelId | GUID | O id de modelo do dispositivo. |
| System.Devices.Aep.ModelName | String | O nome do modelo do dispositivo. |
| System.Devices.Aep.ProtocolId | GUID | Indica o protocolo usado para descobrir esse dispositivo AssocationEndpoint. |
| System.Devices.Aep.SignalStrength | Int32 | A intensidade do sinal do dispositivo. Esta propriedade só é aplicável para alguns protocolos. |
| System.ItemNameDisplay | String | O melhor nome de exibição para o dispositivo. |
Propriedades AssociationEndpointContainer
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.AepContainer.Categories | String[] | As categorias das quais o dispositivo faz parte. Por exemplo, impressora ou câmera. |
| System.Devices.AepContainer.Children | String[] | A coleção de ids para os objetos AssocationEndpoint que fazem parte desse contêiner. |
| System.Devices.AepContainer.CanPair | Booliano | Indica se um dos dispositivos filho AssociationEndpoint pode ser emparelhado com o sistema ou não. DeviceInformationPairing.CanPair é derivado dessa propriedade. |
| System.Devices.AepContainer.ContainerId | GUID | Identidade deste dispositivo. Esse também é o valor de DeviceInformation.Id, mas no formato GUID. |
| System.Devices.AepContainer.IsPaired | Booliano | Indica se um dos dispositivos filho AssociationEndpoint está emparelhado no momento. DeviceInformationPairing.IsPaired é derivado dessa propriedade. |
| System.Devices.AepContainer.IsPresent | Booliano | Indica se um dos dispositivos filho AssociationEndpoint está presente no momento, o que significa que o dispositivo está ativo e foi descoberto pela rede ou protocolo sem fio. Depois que um dispositivo é emparelhado com o sistema, ele é armazenado em cache. Depois disso, o dispositivo será descoberto automaticamente ao consultar objetos AssociationEndpoint. Por causa disso, você não pode confiar em apenas descobrir o dispositivo com uma consulta para indicar se ele é ou não utilizável no momento. É por isso que essa propriedade é importante. |
| System.Devices.AepContainer.Manufacturer | String | O fabricante do dispositivo. |
| System.Devices.AepContainer.ModelIds | String[] | Uma lista de ids de modelo para o dispositivo. Cada modelo é um GUID em forma de cadeia de caracteres. |
| System.Devices.AepContainer.ModelName | String | O nome do modelo do dispositivo. |
| System.Devices.AepContainer.ProtocolIds | GUID[] | Uma lista de ids de protocolo que contribuíram para a criação desse objeto AssociationEndpointContainer. Lembre-se de que um dispositivo AssociationEndpointContainer é criado coletando todos os dispositivos AssociationEndpoint descobertos em protocolos diferentes para o mesmo dispositivo físico. |
| System.Devices.AepContainer.SupportedUriSchemes | String[] | Lista de esquemas de URI de conversão suportados por este dispositivo. |
| System.Devices.AepContainer.SupportsAudio | Booliano | Indica se este dispositivo suporta conversão de áudio. |
| System.Devices.AepContainer.SupportsImages | Booliano | Indica se este dispositivo suporta conversão de imagens. |
| System.Devices.AepContainer.SupportsVideo | Booliano | Indica se este dispositivo suporta conversão de vídeo. |
| System.ItemNameDisplay | String | O melhor nome de exibição para o dispositivo. |
Propriedades AssociationEndpointService
| Nome | Tipo | Descrição |
|---|---|---|
| System.Devices.AepService.AepId | String | O identificador do objeto pai AssociationEndpoint. |
| System.Devices.AepService.ContainerId | GUID | O identificador do objeto pai AssociationEndpointContainer. |
| System.Devices.AepService.ParentAepIsPaired | Booliano | Indica se o objeto pai AssociationEndpoint está emparelhado com o sistema. |
| System.Devices.AepService.ProtocolId | GUID | Identidade do protocolo usado para descobrir este dispositivo. |
| System.Devices.AepService.ServiceClassId | GUID | Identidade do serviço representado por este dispositivo. |
| System.Devices.AepService.ServiceId | String | Identidade desse serviço. Esse também é o valor de DeviceInformation.Id. |
| System.ItemNameDisplay | String | O melhor nome de exibição para o serviço. |