Method SearchAsync

SearchAsync()

Performs a search for all devices using the default search timeout.

Declaration

public Task<IEnumerable<DiscoveredSsdpDevice>> SearchAsync()

Returns

Type	Description
Task<System.Collections.Generic.IEnumerable<DiscoveredSsdpDevice>>	A task whose result is an System.Collections.Generic.IEnumerable<T> of DiscoveredSsdpDevice instances, representing all found devices.

SearchAsync(String)

Performs a search for the specified search target (criteria) and default search timeout.

Declaration

public Task<IEnumerable<DiscoveredSsdpDevice>> SearchAsync(string searchTarget)

Parameters

Type	Name	Description
System.String	searchTarget	The criteria for the search. Value can be; Root devices upnp:rootdevice Specific device by UUID uuid:<device uuid> Device type Fully qualified device type starting with urn: i.e urn:schemas-upnp-org:Basic:1

Returns

Type	Description
Task<System.Collections.Generic.IEnumerable<DiscoveredSsdpDevice>>	A task whose result is an System.Collections.Generic.IEnumerable<T> of DiscoveredSsdpDevice instances, representing all found devices.

SearchAsync(TimeSpan)

Performs a search for all devices using the specified search timeout.

Declaration

public Task<IEnumerable<DiscoveredSsdpDevice>> SearchAsync(TimeSpan searchWaitTime)

Parameters

Type	Name	Description
System.TimeSpan	searchWaitTime	The amount of time to wait for network responses to the search request. Longer values will likely return more devices, but increase search time. A value between 1 and 5 seconds is recommended by the UPnP 1.1 specification, this method requires the value be greater 1 second if it is not zero. Specify TimeSpan.Zero to return only devices already in the cache.

Returns

Type	Description
Task<System.Collections.Generic.IEnumerable<DiscoveredSsdpDevice>>	A task whose result is an System.Collections.Generic.IEnumerable<T> of DiscoveredSsdpDevice instances, representing all found devices.

SearchAsync(String, TimeSpan)

Performs a search for the specified search target (criteria) and search timeout.

Declaration

public Task<IEnumerable<DiscoveredSsdpDevice>> SearchAsync(string searchTarget, TimeSpan searchWaitTime)

Parameters

Type	Name	Description
System.String	searchTarget	The criteria for the search. Value can be; Root devices upnp:rootdevice Specific device by UUID uuid:<device uuid> Device type A device namespace and type in format of urn:<device namespace>:device:<device type>:<device version> i.e urn:schemas-upnp-org:device:Basic:1 Service type A service namespace and type in format of urn:<service namespace>:service:<servicetype>:<service version> i.e urn:my-namespace:service:MyCustomService:1
System.TimeSpan	searchWaitTime	The amount of time to wait for network responses to the search request. Longer values will likely return more devices, but increase search time. A value between 1 and 5 seconds is recommended by the UPnP 1.1 specification, this method requires the value be greater 1 second if it is not zero. Specify TimeSpan.Zero to return only devices already in the cache.

Returns

Type	Description
Task<System.Collections.Generic.IEnumerable<DiscoveredSsdpDevice>>	A task whose result is an System.Collections.Generic.IEnumerable<T> of DiscoveredSsdpDevice instances, representing all found devices.

Remarks

By design RSSDP does not support 'publishing services' as it is intended for use with non-standard UPnP devices that don't publish UPnP style services. However, it is still possible to use RSSDP to search for devices implemetning these services if you know the service type.