1 files changed, 33 insertions, 0 deletions
diff --git a/RSSDP/ISocketFactory.cs b/RSSDP/ISocketFactory.cs
new file mode 100644
index 000000000..3e7d7facb
--- /dev/null
+++ b/RSSDP/ISocketFactory.cs
@@ -0,0 +1,33 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Rssdp.Infrastructure
+{
+	/// <summary>
+	/// Implemented by components that can create a platform specific UDP socket implementation, and wrap it in the cross platform <see cref="IUdpSocket"/> interface.
+	/// </summary>
+	public interface ISocketFactory
+	{
+
+		/// <summary>
+		/// Createa a new unicast socket using the specified local port number.
+		/// </summary>
+		/// <param name="localPort">The local port to bind to.</param>
+		/// <returns>A <see cref="IUdpSocket"/> implementation.</returns>
+		IUdpSocket CreateUdpSocket(int localPort);
+
+		/// <summary>
+		/// Createa a new multicast socket using the specified multicast IP address, multicast time to live and local port.
+		/// </summary>
+		/// <param name="ipAddress">The multicast IP address to bind to.</param>
+		/// <param name="multicastTimeToLive">The multicast time to live value. Actually a maximum number of network hops for UDP packets.</param>
+		/// <param name="localPort">The local port to bind to.</param>
+		/// <returns>A <see cref="IUdpSocket"/> implementation.</returns>
+		[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "ip", Justification="IP is a well known and understood abbreviation and the full name is excessive.")]
+		IUdpSocket CreateUdpMulticastSocket(string ipAddress, int multicastTimeToLive, int localPort);
+
+	}
+}