Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik de Windows.Devices.Enumeration API's om apparaten op te sommen via draadloze en netwerkprotocollen.
Belangrijke API's
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. Hiervoor hebben de Windows.Devices.Enumeration API's drie verschillende soorten 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 dat de Wi-Fi radio zoekt naar Wi-Fi Direct-apparaten als u met name 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.
| Protocol- of netwerkapparaattype | Identiteitsbewijs |
|---|---|
| UPnP (inclusief DIAL en DLNA) | {0e261de4-12f0-46e6-91ba-428607ccef64} |
| Webservices op apparaten (WSD) | {782232aa-a2f9-4993-971b-aedc551346b0} |
| Wi-Fi Direct | {0407d24e-53de-4c9a-9ba1-9ced54641188} |
| DNS-servicedetectie (DNS-SD) | {4526e8c1-8aac-4153-9b16-55e86ada0e54} |
| Servicepunt | {d4bf61b3-442e-4ada-882d-fa7B70c832d9} |
| Netwerkprinters (Active Directory-printers) | {37aba761-2124-454c-8d82-c42962c2de2b} |
| Windows connect now (WNC) | {4c1b1ef8-2f62-4b9f-9bc5-b21ab636138f} |
| WiGig-docks | {a277f3a5-8764-4f88-8045-4c5e962640b1} |
| Wi-Fi voorziening voor HP-printers | {c85ef710-f344-4792-bb6d-85a4346f1e69} |
| Bluetooth | {e0cbf06c-cd8b-4647-bb8a-263b43f0f974} |
| Bluetooth LE | {bb7bb05e-5972-42b5-94fc-76eaa7084d49} |
| Netwerkcamera | {b8238652-b500-41eb-b4f3-4234f7f5ae99} |
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.
Deze AQS-query's zijn voor alle UPnP-AssociationEndpoint-objecten wanneer de DeviceInformationKind- is ingesteld op AssociationEndpoint.
System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
Deze AQS-query's voor alle UPnP- en WSD-AssociationEndpoint-objecten wanneer de DeviceInformationKind is ingesteld op AssociationEndpoint.
System.Devices.Aep.ProtocolId:="{782232aa-a2f9-4993-971b-aedc551346b0}" OR
System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
Deze AQS-query voor alle UPnP-AssociationEndpointService--objecten wanneer de DeviceInformationKind- is ingesteld op AsssociationEndpointService-.
System.Devices.AepService.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
Met deze AQS-query's worden AssociationEndpointContainer objecten opgevraagd wanneer de DeviceInformationKind is ingesteld op AssociationEndpointContainer, maar ze kunnen alleen worden gevonden door het UPnP-protocol te inventariseren. 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}"