Enumerar dispositivos em uma rede

Usa o Windows. APIs Devices.Enumeration para enumerar dispositivos através de protocolos sem fios e em rede.

Enumeração de dispositivos através de protocolos em rede ou sem fios

Por vezes, é necessário enumerar dispositivos que não estão conectados localmente e só podem ser descobertos através de protocolos wireless ou de rede. Para tal, as APIs Windows.Devices.Enumeration têm três tipos diferentes de objetos de dispositivo: o AssociationEndpoint (AEP), o AssociationEndpointContainer (AEP Container) e o AssociationEndpointService (AEP Service). Como grupo, estes são designados por AEPs ou objetos AEP.

Algumas APIs de dispositivos fornecem uma string seletora que pode usar para enumerar através dos objetos AEP disponíveis. Isto pode incluir tanto os dispositivos emparelhados como os que não estão emparelhados com o sistema. Alguns dos dispositivos podem não precisar de emparelhamento. Essas APIs de dispositivo podem tentar emparelhar o dispositivo se for necessário emparelhá-lo antes de interagir com ele. Wi-Fi Direct é um exemplo de APIs que seguem este padrão. Se essas APIs de dispositivo não emparelarem automaticamente o dispositivo, pode emparelhá-lo usando o objeto DeviceInformationPairing disponível em DeviceInformation.Pairing.

No entanto, pode haver casos em que queira descobrir dispositivos manualmente por conta própria, sem usar uma sequência seletora pré-definida. Por exemplo, pode simplesmente precisar de recolher informação sobre dispositivos AEP sem interagir com eles ou pode querer encontrar mais objetos AEP do que aqueles que serão descobertos com a cadeia seletora pré-definida. Neste caso, irá construir a sua própria string seletora e usá-la seguindo as instruções em Construir um seletor de dispositivo.

Quando constrói o seu próprio seletor, é fortemente recomendado que limite o âmbito de enumeração aos protocolos que lhe interessam. Por exemplo, não pretende que o rádio Wi‑Fi procure dispositivos Wi‑Fi Direct se estiver particularmente interessado em dispositivos UPnP. O Windows definiu uma identidade para cada protocolo que pode usar para definir o âmbito da sua enumeração. A tabela seguinte lista os tipos de protocolo e identificadores.

Exemplos de Sintaxe Avançada de Consultas (AQS)

Cada tipo de AEP tem uma propriedade que pode usar para restringir a sua enumeração a um protocolo específico. Lembra-te que podes usar o operador OR num filtro AQS para combinar vários protocolos. Aqui estão alguns exemplos de cadeias de filtro AQS que mostram como pesquisar dispositivos AEP.

Este AQS consulta todos os objetos UPnP AssociationEndpoint quando o DeviceInformationKind está definido como AsssociationEndpoint.

System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"

Este AQS consulta todos os objetos UPnP e WSD AssociationEndpoint quando o DeviceInformationKind está definido para AsssociationEndpoint.

System.Devices.Aep.ProtocolId:="{782232aa-a2f9-4993-971b-aedc551346b0}" OR
System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"

Este AQS consulta todos os objetos UPnP AssociationEndpointService se o DeviceInformationKind estiver definido como AsssociationEndpointService.

System.Devices.AepService.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"

Este AQS consulta objetos AssociationEndpointContainer quando o DeviceInformationKind está definido para AssociationEndpointContainer, mas só os encontra enumerando o protocolo UPnP. Normalmente, não seria útil enumerar contentores que vêm apenas de um protocolo. No entanto, isto pode ser útil ao limitar o filtro a protocolos onde sabe que o seu dispositivo pode ser descoberto.

System.Devices.AepContainer.ProtocolIds:~~"{0e261de4-12f0-46e6-91ba-428607ccef64}"