transbuf.h

著名的 helix realplayer 基于手机 symbian 系统的 播放器全套源代码

/* ***** BEGIN LICENSE BLOCK ***** 
 * Version: RCSL 1.0/RPSL 1.0 
 *  
 * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
 *      
 * The contents of this file, and the files included with this file, are 
 * subject to the current version of the RealNetworks Public Source License 
 * Version 1.0 (the "RPSL") available at 
 * http://www.helixcommunity.org/content/rpsl unless you have licensed 
 * the file under the RealNetworks Community Source License Version 1.0 
 * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
 * in which case the RCSL will apply. You may also obtain the license terms 
 * directly from RealNetworks.  You may not use this file except in 
 * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
 * applicable to this file, the RCSL.  Please see the applicable RPSL or 
 * RCSL for the rights, obligations and limitations governing use of the 
 * contents of the file.  
 *  
 * This file is part of the Helix DNA Technology. RealNetworks is the 
 * developer of the Original Code and owns the copyrights in the portions 
 * it created. 
 *  
 * This file, and the files included with this file, is distributed and made 
 * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
 * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
 * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
 * 
 * Technology Compatibility Kit Test Suite(s) Location: 
 *    http://www.helixcommunity.org/content/tck 
 * 
 * Contributor(s): 
 *  
 * ***** END LICENSE BLOCK ***** */ 

#ifndef _TRANSPORT_BUFFER_H_
#define _TRANSPORT_BUFFER_H_

#include "hxpends.h"
#include "hxbitset.h"
#include "timeval.h"
#include "hxtbuf.h"
#include "cachobj.h"

#include "hxthread.h"

class HX_deque;
class ClientPacket;
class RTSPTransport;

class PendingPacket
{
  public:
    PendingPacket(UINT32 ulSeqNo, UINT32 arrivalTime);
    ~PendingPacket();

    UINT32 m_ulSequenceNumber;
    UINT32 m_ulNumPktsBehind;
    UINT32 m_ulArrivalTime;
};

typedef enum
{
    TRANSBUF_INITIALIZING,
    TRANSBUF_FILLING,
    TRANSBUF_READY
} TRANSBUF_STATUS;

class BufferTimer
{
public:
    BufferTimer() {};
    ~BufferTimer() {};

    Timeval		m_StartTime;
    Timeval		m_PreviousTime;
    Timeval		m_LastTime;
    Timeval		m_PauseTime;
};

class RTSPTransportBuffer
{
public:
    
    RTSPTransportBuffer(RTSPTransport* pOwner, UINT16 uStreamNumber,
                        UINT32 bufferDuration, UINT32 maxBufferDuration,
                        UINT32 growthRate, UINT32 wrapSequenceNumber);
    ~RTSPTransportBuffer();

    void		Reset();
    void		Grow();
    void		SetEndPacket(UINT16 uSeqNo,
			             UINT16 uReliableSeqNo,
			             BOOL   bPacketSent,
			             UINT32 uTimestamp);
    void		InformSourceStopped(void);
    void		InformTimestampRange(UINT32 ulStartTimestamp,
					     UINT32 ulEndTimestamp,
					     UINT32 ulEndDelayTolerance = 0);

    HX_RESULT		Init(UINT16 uSeqNo);
    HX_RESULT		Add(ClientPacket* pPacket);
    HX_RESULT		Insert(ClientPacket* pPacket);
    HX_RESULT		Flush();
    HX_RESULT		GetPacket(ClientPacket*& pPacket);
    HX_RESULT		StartPackets();
    HX_RESULT		StopPackets();
    void		ReleasePackets();
    HX_RESULT		GetStatus(UINT16& uStatusCode, 
			          UINT16& ulPercentDone);
    HX_RESULT		GetCurrentBuffering(INT64&  llLowestTimestamp, 
					    INT64&  llHighestTimestamp,
					    UINT32& ulNumBytes,
					    BOOL&   bDone);
    
    BOOL		IsSourceDone(void) {return m_bIsEnded;};

    HX_RESULT		UpdateStatistics(ULONG32& ulNormal,
			                 ULONG32& ulLost,
			                 ULONG32& ulLate,
			                 ULONG32& ulResendRequested,
			                 ULONG32& ulResendReceived,
			                 ULONG32& ulAvgBandwidth,
			                 ULONG32& ulCurBandwidth,
					 ULONG32& ulTotal30,
					 ULONG32& ulLost30,
					 ULONG32& ulDuplicate,
					 ULONG32& ulOutOfOrder);
    HX_RESULT		SetupForACKPacket(UINT16& uSeqNo,
			                  CHXBitset& pBitset,
			                  UINT16& uBitCount,
			                  BOOL& didACK,
			                  BOOL& bLostHigh,
			                  BOOL& bNeedAnotherACK);
    UINT32		GetIndex(UINT32 uBaseSequenceNumber, UINT16 uSeqNo);
    UINT32		GetPacketIndex(UINT16 uSeqNo);
    UINT32		GetSeekIndex(UINT16 uSeqNo);
    UINT32		GetACKIndex(UINT16 uSeqNo);
    void		InitTimer();
    void		InitializeTime(BufferTimer* Timer);
    void		UpdateTime(BufferTimer* Timer);
    void		SetMulticast();
    void		SetLive() { m_bIsLive = TRUE; }
    Timeval		GetTime(BufferTimer* Timer);
    Timeval		GetTime();
    Timeval		AdjustedStartTime(BufferTimer* Timer);
    Timeval		AdjustedLastTime(BufferTimer* Timer);
    void		Pause();
    void		Resume();
    void		SanitizePacketQueue();
    void		CheckForSourceDone();
    void		UpdateStatsFromPacket(ClientPacket* pPacket);
    void		SeekFlush();
    void		SetBufferDepth(UINT32 uMilliseconds);

    void		EnterPrefetch(void);
    void		LeavePrefetch(void);
    void		DoPrefetch(void);

    void		EnterFastStart(void) { m_bFastStart = TRUE; };
    void		LeaveFastStart(void) { m_bFastStart = FALSE; };

    HX_RESULT		GetPacketFromCache(ClientPacket*& pPacket);
    HX_RESULT		GetPacketFromQueue(ClientPacket*& pPacket);

    HX_RESULT           GetTransportBufferInfo(UINT32& ulLowestTimestamp,
					       UINT32& ulHighestTimestamp,
					       UINT32& ulBytesBuffered);

    BOOL                OverByteLimit() const;
    void                SetByteLimit(UINT32 ulByteLimit);
    UINT32              GetByteLimit() const;
    void                ConvertToDroppedPkt(ClientPacket*& pPacket);

    void Func();

private:
    class RTSPTransportBufferCallback : public IHXCallback
    {
    public:
        RTSPTransportBuffer*  m_pTransBuff;
   
        RTSPTransportBufferCallback(RTSPTransportBuffer* pTransBuff);
        //IUnknown methods
        STDMETHOD(QueryInterface) (THIS_ REFIID riid, void** ppvObj);
        STDMETHOD_(ULONG32,AddRef) (THIS);
        STDMETHOD_(ULONG32,Release) (THIS);

        //IRMACallback methods
        STDMETHOD(Func) (THIS); 

        void Clear();

    protected:
        ~RTSPTransportBufferCallback();

        LONG32 m_lRefCount;
    };
    CallbackHandle               m_CallbackHandle;
    RTSPTransportBufferCallback* m_pCallBack;
    HXMutex*                     m_pPendingLock;
    
    //To keep track of packets we think might be lost.
    CHXSimpleList		 m_PendingPackets;

    IHXScheduler*	m_pScheduler;
#if defined(HELIX_FEATURE_FIFOCACHE)
    IHXFIFOCache*	m_pFIFOCache;
#else
    void*		m_pFIFOCache;
#endif /* HELIX_FEATURE_FIFOCACHE */
    RTSPTransport*	m_pOwner;
    UINT16		m_uStreamNumber;
    HX_deque*		m_pPacketDeque;
    CHXSimpleList	m_pHoldList;
    TRANSBUF_STATUS	m_status;
    BOOL		m_bPrefetch;
    BOOL		m_bFastStart;
    BOOL		m_bCacheIsEmpty;
    BOOL		m_bIsInitialized;
    BOOL		m_bWaitingForSeekFlush;
    BOOL		m_bWaitingForLiveSeekFlush;
    BOOL		m_bFlushHolding;
    BOOL		m_bIsEnded;
    BOOL		m_bQueueIsEmpty;
    BOOL		m_bStreamBegin;
    BOOL		m_bStreamDone;
    BOOL		m_bSourceStopped;
    BOOL		m_bACKDone;
    BOOL		m_bStreamDoneSent;
    BOOL		m_bPaused;
    BOOL		m_bPausedHack;
    UINT32		m_ulTSRollOver;
    UINT32		m_bufferDuration;
    UINT32		m_maxBufferDuration;
    UINT32		m_growthRate;
    UINT32		m_wrapSequenceNumber;
    UINT32		m_ulFrontTimeStampCached;
    UINT32		m_ulRearTimeStampCached;
    UINT16		m_uReliableSeqNo;
    UINT16		m_uEndReliableSeqNo;
    UINT16		m_uFirstSequenceNumber;
    UINT16		m_uLastSequenceNumber;
    UINT16		m_uACKSequenceNumber;
    UINT16		m_uEndSequenceNumber;
    UINT16		m_uSeekSequenceNumber;
    UINT16		m_uSeekCount;
    UINT32		m_uNormal;
    UINT32		m_ulDuplicate;
    UINT32		m_ulOutOfOrder;
    UINT32		m_uLost;
    UINT32		m_uLate;
    UINT32		m_ulIndex30;
    UINT32		m_ulTotal30[30];
    UINT32		m_ulLost30[30];
    UINT32		m_uResendRequested;
    UINT32		m_uResendReceived;
    INT64		m_uByteCount;
    INT64		m_uLastByteCount;
    UINT32		m_uAvgBandwidth;
    UINT32		m_uCurBandwidth;
    UINT32		m_ulLastLost30;
    UINT32		m_ulLastTotal30;
    UINT32		m_uLastTimestamp;
    UINT32		m_uStartTimestamp;
    UINT32		m_uEndTimestamp;
    UINT32		m_ulEndDelayTolerance;
    BOOL		m_bExpectedTSRangeSet;
    BufferTimer		m_StatisticsTime;
    BufferTimer		m_PacketTime;
    BufferTimer		m_LastPacketTime;
    BOOL		m_bPacketsStarted;
    UINT32		m_ulCurrentQueueByteCount;
    UINT32		m_ulCurrentCacheByteCount;
    BOOL		m_bAtLeastOnePacketReceived;
    BOOL		m_bAtLeastOneResetHandled;
    UINT32		m_ulFirstTimestampReceived;
    UINT32		m_ulLastTimestampReceived;
    UINT32		m_ulBufferingStartTime;
    UINT32		m_ulLastGrowTime;
    BOOL		m_bMulticast;
    BOOL		m_bMulticastReset;
    BOOL		m_bMulticastReliableSeqNoSet;
    BOOL		m_bIsLive;
    BOOL		m_bSparseStream;
    UINT32              m_ulByteLimit; /* Max number of bytes allowed in
					* in queue. 0 means unlimited
					*/
};

inline UINT32
RTSPTransportBuffer::GetPacketIndex(UINT16 uSeqNo)
{
    return GetIndex(m_uFirstSequenceNumber, uSeqNo);
}

inline UINT32
RTSPTransportBuffer::GetSeekIndex(UINT16 uSeqNo)
{
    return GetIndex(m_uSeekSequenceNumber, uSeqNo);
}

inline UINT32
RTSPTransportBuffer::GetACKIndex(UINT16 uSeqNo)
{
    return GetIndex(m_uACKSequenceNumber, uSeqNo);
}

inline void                
RTSPTransportBuffer::SetByteLimit(UINT32 ulByteLimit)
{
    m_ulByteLimit = ulByteLimit;
}

inline UINT32
RTSPTransportBuffer::GetByteLimit() const
{
    return m_ulByteLimit;
}

#endif /* _TRANSPORT_BUFFER_H_ */