Apparaten opsommen via een netwerk

Gebruik de Windows. Devices.Enumeration API's om apparaten op te sommen via draadloze en netwerkprotocollen.

Apparaten opsommen via netwerk- of draadloze protocollen

Soms moet u apparaten opsommen die niet lokaal zijn verbonden en die alleen kunnen worden gedetecteerd via een draadloos of netwerkprotocol. Om dit te doen hebben de Windows.Devices.Enumeration-API's drie verschillende typen apparaatobjecten: de AssociationEndpoint (AEP), de AssociationEndpointContainer (AEP-container) en de AssociationEndpointService (AEP-service). Als groep worden deze AEPs- of AEP-objecten genoemd.

Sommige apparaat-API's bieden een selectortekenreeks die u kunt gebruiken om de beschikbare AEP-objecten te inventariseren. Dit kan zowel apparaten bevatten die zijn gekoppeld en die niet zijn gekoppeld aan het systeem. Voor sommige apparaten is koppelen mogelijk niet vereist. Deze apparaat-API's kunnen proberen het apparaat te koppelen als het nodig is voordat er interactie met het apparaat wordt uitgevoerd. Wi-Fi Direct is een voorbeeld van API's die dit patroon volgen. Als deze apparaat-API's het apparaat niet automatisch koppelen, kunt u het koppelen met behulp van het DeviceInformationPairing-object dat beschikbaar is via DeviceInformation.Pairing.

Er kunnen echter gevallen zijn waarin u apparaten zelf handmatig wilt detecteren zonder een vooraf gedefinieerde selectortekenreeks te gebruiken. U hoeft bijvoorbeeld alleen informatie over AEP-apparaten te verzamelen zonder er interactie mee te hebben of u wilt meer AEP-objecten vinden dan wordt gedetecteerd met de vooraf gedefinieerde selectortekenreeks. In dit geval bouwt u uw eigen selectortekenreeks en gebruikt u deze volgens de instructies onder Een apparaatkiezer bouwen.

Wanneer u uw eigen selector bouwt, wordt het ten zeerste aanbevolen dat u het bereik van opsomming beperkt tot de protocollen waarin u geïnteresseerd bent. U wilt bijvoorbeeld niet de wifi-radio laten zoeken naar Wi‑Fi Direct-apparaten wanneer u specifiek geïnteresseerd bent in UPnP-apparaten. Windows heeft een identiteit gedefinieerd voor elk protocol dat u kunt gebruiken om uw opsomming te bepalen. De volgende tabel bevat de protocoltypen en id's.

Voorbeelden van Geavanceerde querysyntaxis (AQS)

Elk type AEP heeft een eigenschap die u kunt gebruiken om uw opsomming te beperken tot een specifiek protocol. Houd er rekening mee dat u de OR-operator in een AQS-filter kunt gebruiken om meerdere protocollen te combineren. Hier volgen enkele voorbeelden van AQS-filterreeksen die laten zien hoe u een query kunt uitvoeren op AEP-apparaten.

Met deze AQS worden alle UPnP-AssociationEndpoint-objecten opgevraagd als de DeviceInformationKind is ingesteld op AsssociationEndpoint.

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

Deze AQS zoekt naar alle UPnP- en WSD-AssociationEndpoint-objecten wanneer DeviceInformationKind is ingesteld op AsssociationEndpoint.

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

Deze AQS zoekt naar alle UPnP-AssociationEndpointService-objecten als DeviceInformationKind is ingesteld op AsssociationEndpointService.

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

Deze AQS doorzoekt AssociationEndpointContainer-objecten wanneer DeviceInformationKind is ingesteld op AssociationEndpointContainer, maar vindt deze alleen door het UPnP-protocol te enumereren. Normaal gesproken is het niet handig om containers op te sommen die slechts afkomstig zijn van één protocol. Dit kan echter handig zijn door het filter te beperken tot protocollen waarin u weet dat uw apparaat kan worden gedetecteerd.

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