Chapter 1

The receive queue is a list of datagrams (referred to as 'packets' in its API) waiting to be
received by clients. Packets are added to the list by the Receive() function. A packet just
added to the list is offered to all sessions to see whether it can be received. When a session
changes its settings or issues a receive, it checks the receive queue using
CheckPackets() to see if there are any packets waiting for that session. By this means, a
packet is delivered to a session as soon as possible.
Here is the definition:
class CGsdpReceiveQueue : public CGsdpQueueBase
{
public:
enum TReceiveCheck { EAllowZero, EDontAllowZero };
public:
// construct
static CGsdpReceiveQueue* NewL(CGsdpServer& aServer);
// functions
void Receive(TUint32 aGameProtocol, TUint32 aToPort, const
TDesC8&
aFromAddress, TUint32 aFromPort, const TDesC8& aData);
void CheckPackets(CGsdpSession* aSession);
private:
CGsdpReceiveQueue(CGsdpServer& aServer);
private:
CGsdpServer& iServer;
};
On construction, CGsdpQueueBase creates 10 blank packets and adds them to the iSlots
queue. When a packet is received, the following processing takes place:
void CGsdpReceiveQueue::Receive(TUint32 aGameProtocol, TUint32
aToPort,
const TDesC8& aFromAddress, TUint32 aFromPort, const TDesC8&
aData)
{
TGsdpPacket* packet=AddPacket(aGameProtocol, aToPort,
aFromAddress,
aFromPort, aData);
if (!packet)
return;
CGsdpSession* session=iServer.SessionForPacket(*packet);
if (!session)
return;
session->ReceivePacket(*packet);
}