A Multicast Wrapper Class

Surprisingly, there are very few resources on the Internet for multicast programming under WinSock and I think that this class that I wrote for my project will come in handy to some of you. The Code is amply commented and not too hard to follow. Points worth mentioning are discussed below and if any help is required don't hesitate to contact me.

I will assume that you are aware of the concept of multicasting and the socket API's. The class CMulticastSocket derives from MFC CAsyncSocket and will allow the programmer to use the following facilities:

• Join a multicast host group given its multicast IP address and Port
• Leave the host group
• Send/receive data to/from the host group
• Set the time to live (TTL) and Loopback options on the sending socket

Join a Group

To join a multicast group the following API call can be used

The function returns true if successful, otherwise false.

All fields are pretty self explanatory but, for those who may try to go into the details of the code, I'll mention a technical problem that is faced with the loopback option. Not all multicast interfaces support the loopback option in which case, the loopback is by default enabled. Any packet sent to the host group will loop back to the sending interface. In short, the sender will receive any packet that he sends whether he/she likes it or not.

CMulticastSocket handles this problem internally. If the multicast interface does not support loopback option and the user wants to disable loopback, the class ignore any packets that it receives from the IP/Port address of the sending socket of the user. This way, all messages sent by you that loopback to the interface are ignored by the OnReceive function of the class.

nTTL     contains the value of Time to live for the packets. The TTL determine the number of hops of the packet can make before it dies.
 

Leave a Group
To leave a multicast hostgroup that you are connected to use

    Bool CMulticastSocket::LeaveGroup()

Returns true if successful, otherwise false.
 

Send Data to host group
    Bool CMulticastSocket::SendTo(const char* strMessage, int nSize)

Returns true if successful, otherwise false.

strMessage contains the Message to be sent.
nSize is the size of the Message
 

Receive Data from host group
    void CMulticastSocket::OnReceive(int nErrorCode)

This function overrides the CAsyncSocket OnReceive Notification Message. Within this message, there are check to ensure loopback is working correctly. The programmer can write his/her code in this function to handle the data that is received.
 

Class Data Members

A description of the class data members is as follows. This should come in particularly handy if you want to make changes to the code to suit your needs.
 

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here