packetq.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:6k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef _PACKETQ_H_
  36. #define _PACKETQ_H_
  37. // #define _PKTQ_DEBUG
  38. class PacketQueue
  39. {
  40. public:
  41.     /****** Public Class Methods ******************************************/
  42.     PacketQueue(const UINT32 ulWinSize = 25,
  43. const UINT16 unProbation = 2,
  44. const UINT32 ulWinTime = 0,
  45. const BOOL bUsesRTPPackets = FALSE);
  46.     ~PacketQueue();
  47.     HX_RESULT Init(IHXCommonClassFactory* pClassFactory);
  48.     HX_RESULT AddPacket(UINT16 unSeq, 
  49.   IHXPacket* pPacket,
  50.   ULONG32 ulArrivalTime = 0);
  51.     HX_RESULT GetPacket(REF(IHXPacket*) pPacket, ULONG32 ulTimeNow = 0);
  52.     HX_RESULT GetNextTS(REF(UINT32)ulTS, ULONG32 ulTimeNow = 0);    
  53.     UINT16 GetPercentDone(void);
  54.     ULONG32 GetAge(ULONG32 ulTimeNow);
  55.     /****** inlines ******/
  56.     inline void     SetMinWindowSize(UINT32 ulWinSize);
  57.     inline void     SetMinWindowTime(UINT32 ulWinTime);
  58.     inline UINT32   GetMinWindowSize(void);
  59.     UINT32 GetMinWindowTime(void)   { return m_ulMinWindowTime; }
  60.     inline UINT32   GetLatePktCount(void);    
  61.     inline UINT32   GetQueuedPktCount(void);
  62.     inline BOOL     IsUntouched(void) { return m_bInitial; }
  63.     inline void     SetFlexTimeWindow(BOOL bIsFlexTimeWindow);
  64.     inline BOOL     IsFlexTimeWindow(void)  { return m_bIsFlexTimeWindow; }
  65.         
  66. private:
  67.     class CArrivedPacket
  68.     {
  69.     public:
  70. CArrivedPacket(IHXPacket* pPacket,
  71.        ULONG32 ulArrivalTS)
  72. : m_pPacket(pPacket)
  73. , m_ulArrivalTS(ulArrivalTS)
  74. {
  75.     if (pPacket)
  76.     {
  77. pPacket->AddRef();
  78.     }
  79. }
  80. ~CArrivedPacket()
  81. {
  82.     HX_RELEASE(m_pPacket);
  83. }
  84. IHXPacket* m_pPacket;
  85. ULONG32 m_ulArrivalTS;
  86.     };
  87.     void     ReInitVars(void);
  88.     inline BOOL     IsSeqNumGT(UINT16 seq1, UINT16 seq2)
  89.     {
  90. return (((INT16) (seq1 - seq2)) > 0);
  91.     }
  92.     BOOL     PacketSufficientlyAged(CArrivedPacket* pArrivedPacket,
  93.    ULONG32 ulTimeNow);
  94.     inline BOOL     IsBufferingForSure(void)
  95.     {
  96. BOOL bIsBufferingForSure = FALSE;
  97. if (m_ulMinWindowTime == 0)
  98. {
  99.     bIsBufferingForSure = TRUE;
  100.     if (((UINT32) m_pBuf->GetCount()) >= m_ulMinWindowSize)
  101.     {
  102. bIsBufferingForSure = FALSE;
  103.     }
  104. }
  105. return bIsBufferingForSure;
  106.     }
  107.     CHXMapLongToObj* m_pBuf;
  108.     const UINT16    m_unInitProbation;
  109.     UINT32     m_ulMinWindowSize;
  110.     UINT32     m_ulMinWindowTime;     
  111.     UINT32     m_ulLate;
  112.     UINT32     m_ulLateSinceTermination;
  113.     BOOL     m_bIsFlexTimeWindow;
  114.     BOOL     m_bUsesRTPPackets;
  115.     ULONG32     m_ulLastReturnedArrivalTime;
  116.     UINT16     m_unLastReturnedArrivalSeq;
  117.     BOOL     m_bLastReturnedArrivalSet;
  118.     UINT16     m_unCurrent;
  119.     BOOL     m_bPacketReturned;
  120.     IHXCommonClassFactory* m_pClassFactory;    
  121.     BOOL     m_bInitial;
  122.     UINT16     m_unProbation;
  123. #ifdef _PKTQ_DEBUG
  124.     FILE*     m_pLogFile;
  125. #endif
  126. };
  127. inline void
  128. PacketQueue::SetMinWindowSize(UINT32 ulWinSize)
  129. {
  130. #ifdef _PKTQ_DEBUG
  131.     if (m_pLogFile)
  132.     {
  133. fprintf(m_pLogFile, "**** Setting WindowSize: %un", ulWinSize);
  134. fflush(stdout);
  135.     }
  136. #endif    
  137.     m_ulMinWindowSize = ulWinSize;
  138. }
  139. inline void
  140. PacketQueue::SetMinWindowTime(UINT32 ulWinTime)
  141. {
  142. #ifdef _PKTQ_DEBUG
  143.     if (m_pLogFile)
  144.     {
  145. fprintf(m_pLogFile, "**** Setting WindowTime: %un", ulWinTime);
  146. fflush(stdout);
  147.     }
  148. #endif    
  149.     m_ulMinWindowTime = ulWinTime;
  150. }
  151. inline void 
  152. PacketQueue::SetFlexTimeWindow(BOOL bIsFlexTimeWindow)
  153. {
  154. #ifdef _PKTQ_DEBUG
  155.     if (m_pLogFile)
  156.     {
  157. fprintf(m_pLogFile, "**** Setting Flex TimeWindow: %un", bIsFlexTimeWindow);
  158. fflush(stdout);
  159.     }
  160. #endif // _PKTQ_DEBUG
  161.     m_bIsFlexTimeWindow = bIsFlexTimeWindow; 
  162. }
  163. inline UINT32
  164. PacketQueue::GetMinWindowSize(void)
  165. {
  166.     return m_ulMinWindowSize;
  167. }
  168. inline UINT32   
  169. PacketQueue::GetLatePktCount(void)
  170. {
  171.     return m_ulLate;
  172. }
  173. inline UINT32
  174. PacketQueue::GetQueuedPktCount(void)
  175. {
  176.     return m_pBuf ? m_pBuf->GetCount() : 0;
  177. }
  178. #endif