Wyliczanie urządzeń za pośrednictwem sieci

Użyj interfejsów API Windows.Devices.Enumeration do wykrywania urządzeń za pośrednictwem protokołów bezprzewodowych i sieciowych.

Wyliczanie urządzeń za pośrednictwem protokołów sieciowych lub bezprzewodowych

Czasami należy wyliczyć urządzenia, które nie są podłączone lokalnie i można je odnaleźć tylko za pośrednictwem protokołów bezprzewodowych lub sieciowych. W tym celu interfejsy API Windows.Devices.Enumeration mają trzy różne rodzaje obiektów urządzeń: AssociationEndpoint (AEP), AssociationEndpointContainer (kontener AEP) oraz AssociationEndpointService (usługa AEP). Łącznie określa się je jako AEPs lub obiekty AEP.

Niektóre interfejsy API urządzeń udostępniają ciąg selektora, którego można użyć do wyliczenia dostępnych obiektów AEP. Może to obejmować zarówno urządzenia sparowane z systemem, jak i niesparowane. Niektóre urządzenia mogą nie wymagać parowania. Te interfejsy API urządzeń mogą próbować sparować urządzenie, jeśli jest to konieczne przed rozpoczęciem interakcji z nim. Wi-Fi Direct to przykład interfejsów API, które są zgodne z tym wzorcem. Jeśli te interfejsy API urządzeń nie powodują automatycznie sparowania urządzenia, możesz sparować je przy użyciu obiektu DeviceInformationPairing dostępnego z poziomu DeviceInformation.Pairing.

Jednak mogą wystąpić przypadki ręcznego odnajdywania urządzeń samodzielnie bez użycia wstępnie zdefiniowanego ciągu selektora. Na przykład może być konieczne zebranie informacji o urządzeniach AEP bez interakcji z nimi lub znalezienie większej liczby obiektów AEP niż zostanie odnalezionych przy użyciu wstępnie zdefiniowanego ciągu selektora. W takim przypadku utworzysz własny ciąg selektora i użyjesz go zgodnie z instrukcjami w obszarze Kompilowanie selektora urządzenia.

Podczas tworzenia własnego selektora zdecydowanie zaleca się ograniczenie zakresu wyliczania do protokołów, które Cię interesują. Na przykład nie chcesz, aby moduł Wi‑Fi wyszukiwał urządzenia Wi‑Fi Direct, jeśli szczególnie interesują Cię urządzenia UPnP. Windows zdefiniował tożsamość dla każdego protokołu, którego można użyć do określenia zakresu wyliczenia. W poniższej tabeli wymieniono typy protokołów i identyfikatory.

Przykłady zaawansowanej składni zapytań (AQS)

Każdy rodzaj protokołu AEP ma właściwość, której można użyć, aby ograniczyć wyliczanie do określonego protokołu. Pamiętaj, że możesz użyć operatora OR w filtrze AQS, aby połączyć wiele protokołów. Poniżej przedstawiono kilka przykładów ciągów filtrów AQS, które pokazują, jak wykonywać zapytania dotyczące urządzeń AEP.

To zapytanie AQS wyszukuje wszystkie obiekty UPnP AssociationEndpoint, gdy parametr DeviceInformationKind ma wartość AsssociationEndpoint.

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

To zapytanie AQS wyszukuje wszystkie obiekty UPnP i WSD AssociationEndpoint, gdy element DeviceInformationKind ma wartość AsssociationEndpoint.

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

To zapytanie AQS dotyczy wszystkich obiektów UPnP AssociationEndpointService jeśli DeviceInformationKind jest ustawiona na AssociationEndpointService.

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

To zapytanie AQS wyszukuje obiekty AssociationEndpointContainer, gdy parametr DeviceInformationKind jest ustawiony na AssociationEndpointContainer, ale znajduje je tylko przez enumerację przy użyciu protokołu UPnP. Zazwyczaj nie byłoby przydatne wyliczanie kontenerów, które pochodzą tylko z jednego protokołu. Może to być jednak przydatne, jeśli ograniczysz swój filtr do protokołów, w których można wykryć Twoje urządzenie.

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