• API Documentation
Show / Hide Table of Contents
  • Rssdp
    • CustomHttpHeader
      • CustomHttpHeader
      • Name
      • ToString
      • Value
    • CustomHttpHeadersCollection
      • Add
      • Contains
      • Count
      • CustomHttpHeadersCollection
      • GetEnumerator
      • Item
      • Remove
    • DeviceAvailableEventArgs
      • DeviceAvailableEventArgs
      • DiscoveredDevice
      • IsNewlyDiscovered
    • DeviceEventArgs
      • Device
      • DeviceEventArgs
    • DeviceNetworkType
      • IPv4
      • IPv6
    • DeviceNetworkTypeExtensions
      • GetMulticastIPAddress
    • DeviceUnavailableEventArgs
      • DeviceUnavailableEventArgs
      • DiscoveredDevice
      • Expired
    • DiscoveredSsdpDevice
      • AsAt
      • CacheLifetime
      • DescriptionLocation
      • GetDeviceInfo
      • IsExpired
      • NotificationType
      • ResponseHeaders
      • ToString
      • Usn
    • ExceptionExtensions
      • IsCritical
    • ISsdpLogger
      • LogError
      • LogInfo
      • LogVerbose
      • LogWarning
    • NullLogger
      • Instance
      • LogError
      • LogInfo
      • LogVerbose
      • LogWarning
    • Resource
    • Resource.Attribute
    • Resource.String
      • ApplicationName
      • Hello
    • ServiceEventArgs
      • Service
      • ServiceEventArgs
    • SocketClosedException
      • SocketClosedException
    • SocketFactory
      • CreateUdpMulticastSocket
      • CreateUdpSocket
      • DeviceNetworkType
      • SocketFactory
    • SsdpDevice
      • AddDevice
      • AddService
      • CustomProperties
      • CustomResponseHeaders
      • DeviceAdded
      • DeviceRemoved
      • Devices
      • DeviceType
      • DeviceTypeNamespace
      • DeviceVersion
      • FriendlyName
      • FullDeviceType
      • Icons
      • Manufacturer
      • ManufacturerUrl
      • ModelDescription
      • ModelName
      • ModelNumber
      • ModelUrl
      • OnDeviceAdded
      • OnDeviceRemoved
      • OnServiceAdded
      • OnServiceRemoved
      • PresentationUrl
      • RemoveDevice
      • RemoveService
      • SerialNumber
      • ServiceAdded
      • ServiceRemoved
      • Services
      • SsdpDevice
      • StringToUri
      • Udn
      • Upc
      • Uuid
      • WriteDeviceDescriptionXml
    • SsdpDeviceExtensions
      • ToRootDevice
    • SsdpDeviceIcon
      • ColorDepth
      • Height
      • MimeType
      • Url
      • Width
    • SsdpDeviceLocator
      • SsdpDeviceLocator
    • SsdpDevicePropertiesCollection
      • Add
      • Contains
      • Count
      • GetEnumerator
      • Item
      • Remove
      • SsdpDevicePropertiesCollection
    • SsdpDeviceProperty
      • FullName
      • Name
      • Namespace
      • Value
    • SsdpDevicePublisher
      • SsdpDevicePublisher
    • SsdpEmbeddedDevice
      • RootDevice
      • SsdpEmbeddedDevice
    • SsdpRootDevice
      • CacheLifetime
      • Location
      • SsdpRootDevice
      • ToDescriptionDocument
      • UrlBase
    • SsdpService
      • ControlUrl
      • EventSubUrl
      • FullServiceType
      • ScpdUrl
      • ServiceId
      • ServiceType
      • ServiceTypeNamespace
      • ServiceVersion
      • SsdpService
      • Uuid
      • WriteServiceDescriptionXml
    • SsdpStandardsMode
      • Default
      • Relaxed
      • Strict
    • SsdpTraceLogger
      • LogError
      • LogInfo
      • LogVerbose
      • LogWarning
    • UdpSocket
      • Dispose
      • ReceiveAsync
      • SendTo
      • UdpSocket
  • Rssdp.Infrastructure
    • DisposableManagedObjectBase
      • Dispose
      • IsDisposed
      • ThrowIfDisposed
    • HttpParserBase<T>
      • IsContentHeader
      • Parse
      • ParseHttpVersion
      • ParseStatusLine
    • HttpRequestParser
      • IsContentHeader
      • Parse
      • ParseStatusLine
    • HttpResponseParser
      • IsContentHeader
      • Parse
      • ParseStatusLine
    • ISocketFactory
      • CreateUdpMulticastSocket
      • CreateUdpSocket
      • DeviceNetworkType
    • ISsdpCommunicationsServer
      • BeginListeningForBroadcasts
      • DeviceNetworkType
      • IsShared
      • RequestReceived
      • ResponseReceived
      • SendMessage
      • StopListeningForBroadcasts
      • StopListeningForResponses
      • UdpSendCount
      • UdpSendDelay
    • ISsdpDeviceLocator
      • DeviceAvailable
      • DeviceUnavailable
      • IsSearching
      • NotificationFilter
      • SearchAsync
      • StartListeningForNotifications
      • StopListeningForNotifications
    • ISsdpDevicePublisher
      • AddDevice
      • Devices
      • RemoveDevice
    • IUdpSocket
      • ReceiveAsync
      • SendTo
    • IUpnpDeviceValidator
      • GetValidationErrors
      • ThrowIfDeviceInvalid
    • ReceivedUdpData
      • Buffer
      • ReceivedBytes
      • ReceivedFrom
    • RequestReceivedEventArgs
      • Message
      • ReceivedFrom
      • RequestReceivedEventArgs
    • ResponseReceivedEventArgs
      • Message
      • ReceivedFrom
      • ResponseReceivedEventArgs
    • SsdpCommunicationsServer
      • BeginListeningForBroadcasts
      • DeviceNetworkType
      • Dispose
      • IsShared
      • RequestReceived
      • ResponseReceived
      • SendMessage
      • SsdpCommunicationsServer
      • StopListeningForBroadcasts
      • StopListeningForResponses
      • UdpSendCount
      • UdpSendDelay
    • SsdpConstants
      • DefaultUdpResendCount
      • DefaultUdpResendDelay
      • DefaultUdpSocketBufferSize
      • MaxUdpSocketBufferSize
      • MulticastLinkLocalAddressV6
      • MulticastLocalAdminAddress
      • MulticastPort
      • PnpDeviceTypeRootDevice
      • SsdpDefaultMulticastTimeToLive
      • UpnpDeviceTypeBasicDevice
      • UpnpDeviceTypeNamespace
      • UpnpDeviceTypeRootDevice
    • SsdpDeviceLocatorBase
      • DeviceAvailable
      • DeviceUnavailable
      • Dispose
      • IsSearching
      • NotificationFilter
      • OnDeviceAvailable
      • OnDeviceUnavailable
      • SearchAsync
      • SsdpDeviceLocatorBase
      • StartListeningForNotifications
      • StopListeningForNotifications
    • SsdpDevicePublisherBase
      • AddDevice
      • Devices
      • Dispose
      • Log
      • NotificationBroadcastInterval
      • RemoveDevice
      • SsdpDevicePublisherBase
      • StandardsMode
      • SupportPnpRootDevice
    • UdpEndPoint
      • IPAddress
      • Port
      • ToString
    • Upnp10DeviceValidator
      • GetValidationErrors
      • ThrowIfDeviceInvalid

Method ToRootDevice

ToRootDevice(SsdpDevice)

Returns the root device associated with a device instance derived from SsdpDevice.

Declaration
public static SsdpRootDevice ToRootDevice(this SsdpDevice device)
Parameters
Type Name Description
SsdpDevice device

The device instance to find the SsdpRootDevice for.

Returns
Type Description
SsdpRootDevice

The SsdpRootDevice instance associated with the device instance specified, or null otherwise.

Remarks

The device must be or inherit from SsdpRootDevice or SsdpEmbeddedDevice, otherwise an System.InvalidCastException will occur.

May return null if the device instance is an embedded device not yet associated with a SsdpRootDevice instance yet.

If device is an instance of SsdpRootDevice (or derives from it), returns the same instance cast to SsdpRootDevice.

Exceptions
Type Condition
System.ArgumentNullException

Thrown if device is null.

System.InvalidCastException

Thrown if device is not an instance of or dervied from either SsdpRootDevice or SsdpEmbeddedDevice.

Back to top Copyright (c) 2017 Troy Willmot