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

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 _HXFGBUF_H_
  36. #define _HXFGBUF_H_
  37. /*
  38.  * IHXFragmentedBuffer
  39.  *     STDMETHOD(GetEnumerator)(REF(IEnumHXFragmentedBuffer *));
  40.  *     STDMETHOD(Prepend)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  41.  *     STDMETHOD(Append)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  42.  *     STDMETHOD(Insert)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom, UINT32 ulStartTo);
  43.  *     STDMETHOD(Replace)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom, UINT32 ulStartTo);
  44.  *     STDMETHOD(Get)(UINT32 ulStartFrom, UINT32 ulLengthFrom, REF(UCHAR*) pData, REF(UINT32) ulLength);
  45.  *     STDMETHOD_(UCHAR*, GetBuffer)(UINT32 ulStartFrom, UINT32 ulLengthFrom);
  46.  *
  47.  * IEnumHXFragmentedBuffer
  48.  *     STDMETHOD(Reset)();
  49.  *     STDMETHOD(Next)(UINT32 ulRequested, IHXBuffer *[]arrpbufReturned, REF(UINT32) ulReturned);
  50.  *     STDMETHOD(Skip)(UINT32 ulNumToSkip);
  51.  *     STDMETHOD(Clone)(REF(IEnumHXFragmentedBuffer *)ppefbufClone);
  52.  */
  53. #include "hxtypes.h"
  54. #include "unkimp.h"
  55. #include "ihxfgbuf.h"
  56. #include "hxbuffer.h"
  57. #include "arrenum.h"
  58. DECLARE_INTERFACE_ARRAY_ENUMERATOR(IHXBuffer, IHXEnumFragmentedBuffer);
  59.     /*
  60.      * This class is to allow fragment(s) to be
  61.      * inserted into the middle of existing buffers
  62.      * without re-copying the bytes.
  63.      *
  64.      * Before:
  65.      *     ...
  66.      *     IHXBuffer[100]
  67.      *     ...
  68.      *
  69.      * After:
  70.      *     ...
  71.      *     (_CBufferFragment(0,20))IHXBuffer[20]----
  72.      *     (New)IHXBuffer[43]        -->IHXBuffer[100]
  73.      *     (_CBufferFragment(21,80)IHXBuffer[80]----/
  74.      *     ...
  75.      *
  76.      * XXX Optimize by overriding the new operator.
  77.      *
  78.      * The local implementation should maintain a 
  79.      * static array of BufferFragment arrays 
  80.      * (BufferFragment[n][32]), and return the next 
  81.      * free one.
  82.      * When all BFs are in use, the first dimension
  83.      * should be re-alloced to twice it's size
  84.      * (BufferFragment*[n*2]). The existing pointers 
  85.      * are then copied into it.  A new block
  86.      * of memory to cover the second dimension of 
  87.      * each of the new locations in the first dimension
  88.      * is alloced, (BufferFragment[n*32])
  89.      * then its contents are distrubuted to the first 
  90.      * array.
  91.      * 
  92.      * This has several benefits: 
  93.      * - not copying the data around when growing.
  94.      * - Balancing allocs with wasted space.
  95.      * - Not allocing for every new object.
  96.      * - Fixed second dimension keeps management simple.
  97.      */
  98. class _CBufferFragment
  99.     : public IHXBuffer
  100.     , public CUnknownIMP
  101. {
  102.     DECLARE_UNKNOWN(_CBufferFragment)
  103. public:
  104.     _CBufferFragment()
  105. : m_pData(NULL)
  106. , m_ulStart(0)
  107. , m_ulLength(0)
  108.     {}
  109.     ~_CBufferFragment()
  110.     {HX_RELEASE(m_pData); m_ulStart=0; m_ulLength=0;}
  111.     _CBufferFragment* _SetBuffer(IHXBuffer* pData, UINT32 ulStart, UINT32 ulLength);
  112.     STDMETHOD(Set)(const UCHAR* pData, UINT32 ulLength);
  113.     STDMETHOD(Get)(REF(UCHAR*) pData, REF(UINT32) ulLength);
  114.     STDMETHOD(SetSize)(UINT32 ulLength);
  115.     STDMETHOD_(UINT32, GetSize)();
  116.     STDMETHOD_(UCHAR*, GetBuffer)();
  117. private:
  118.     IHXBuffer* m_pData;
  119.     UINT32 m_ulStart, m_ulLength;
  120. };
  121. class CHXFragmentedBuffer
  122.     : public IHXFragmentedBuffer
  123.     , public IHXBuffer
  124.     , public CUnknownIMP
  125. {
  126.     DECLARE_UNKNOWN(CHXFragmentedBuffer)
  127. private:
  128.     class _CFragment;
  129.     class _CFragmentList;
  130.     friend class _CFragment;
  131.     friend class _CFragmentList;
  132.     /* This class implements the listnodes of fragments
  133.      */
  134.     class _CFragment
  135.     {
  136.     public:
  137. inline _CFragment* Prev(){return m_pPrev;}
  138. inline _CFragment* Next(){return m_pNext;}
  139. _CFragment* SetData(IHXBuffer* pData);
  140. _CFragment* SetData(IHXBuffer* pData, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  141. inline IHXBuffer* GetData(){return m_pData;}
  142. _CFragment* Insert(_CFragment* pNewPrev);
  143. _CFragment* Append(_CFragment* pNewNext);
  144. _CFragment* Remove();
  145. _CFragment():m_pData(NULL),m_pPrev(NULL),m_pNext(NULL){}
  146. ~_CFragment()
  147. {
  148.     HX_RELEASE(m_pData); 
  149.     if(m_pNext)
  150.     {
  151. m_pNext->_SetPrev(m_pPrev);
  152.     }
  153.     if(m_pPrev)
  154.     {
  155. m_pPrev->_SetNext(m_pNext);
  156.     }
  157. }
  158.     private:
  159. inline void _SetPrev(_CFragment* pfrgNew){m_pPrev = pfrgNew;}
  160. inline void _SetNext(_CFragment* pfrgNew){m_pNext = pfrgNew;}
  161. IHXBuffer* m_pData;
  162. _CFragment* m_pPrev;
  163. _CFragment* m_pNext;
  164.     };
  165.     /* This class maintains the First and Last pointers
  166.      * for a list of fragments
  167.      */
  168.     class _CFragmentList
  169.     {
  170.     public:
  171. _CFragmentList()
  172.     : m_pfrgListStart(NULL)
  173.     , m_pfrgListEnd(NULL)
  174.     , m_ulTotal(0)
  175. {}
  176. ~_CFragmentList()
  177. {
  178.     m_pfrgListEnd = NULL; 
  179.     while(m_pfrgListStart)
  180.     {
  181. m_pfrgListStart=m_pfrgListStart->Remove();
  182.     }
  183. }
  184. inline _CFragment* First(){return m_pfrgListStart;}
  185. inline _CFragment* Last(){return m_pfrgListEnd;}
  186. void Remove(_CFragment* pfrgObsolete);
  187. void Insert(_CFragment* pfrgNew, _CFragment* pfrgRelative = NULL);
  188. void Append(_CFragment* pfrgNew, _CFragment* pfrgRelative = NULL);
  189. inline UINT32 GetTotal(){return m_ulTotal;}
  190.     private:
  191. _CFragment* m_pfrgListStart;
  192. _CFragment* m_pfrgListEnd;
  193. UINT32      m_ulTotal;
  194.     };
  195. public:
  196.     CHXFragmentedBuffer()
  197.     {}
  198.     ~CHXFragmentedBuffer(){}
  199.     /* IHXFragmentedBuffer Methods
  200.      */
  201.     STDMETHOD(GetEnumerator)
  202.     (
  203. THIS_ 
  204. IHXEnumFragmentedBuffer** ppefbNewEnum
  205.     );
  206.     STDMETHOD(Prepend)
  207.     (
  208. THIS_ 
  209. IHXBuffer* pBufferFrom, 
  210. ULONG32 ulStartFrom, 
  211. ULONG32 ulLengthFrom
  212.     );
  213.     STDMETHOD(Append)
  214.     (
  215. THIS_ 
  216. IHXBuffer* pBufferFrom, 
  217. ULONG32 ulStartFrom, 
  218. ULONG32 ulLengthFrom
  219.     );
  220.     STDMETHOD(Insert)
  221.     (
  222. THIS_ 
  223. IHXBuffer* pBufferFrom, 
  224. ULONG32 ulStartFrom, 
  225. ULONG32 ulLengthFrom, 
  226. ULONG32 ulStartTo
  227.     );
  228.     STDMETHOD(Replace)
  229.     (
  230. THIS_ 
  231. IHXBuffer* pBufferFrom, 
  232. ULONG32 ulStartFrom, 
  233. ULONG32 ulLengthFrom, 
  234. ULONG32 ulStartTo
  235.     );
  236.     STDMETHOD(Get)
  237.     (
  238. THIS_ 
  239. ULONG32 ulStartFrom, 
  240. ULONG32 ulLengthFrom, 
  241. REF(UCHAR*) pData, 
  242. REF(ULONG32) ulLength
  243.     );
  244.     STDMETHOD_(UCHAR*, GetBuffer)
  245.     (
  246. THIS_ 
  247. ULONG32 ulStartFrom, 
  248. ULONG32 ulLengthFrom
  249.     );
  250.     /* IHXBuffer Methods
  251.      */ 
  252.     STDMETHOD(Set)(const UCHAR* pData, ULONG32 ulLength);
  253.     STDMETHOD(Get)(REF(UCHAR*) pData, REF(ULONG32) ulLength);
  254.     STDMETHOD(SetSize)(ULONG32 ulLength);
  255.     STDMETHOD_(ULONG32, GetSize)();
  256.     STDMETHOD_(UCHAR*, GetBuffer)();
  257. private:
  258.     STDMETHOD(_FindFragment)(UINT32 ulFindIndex, REF(_CFragment*) pfrgCurrent, REF(UINT32) ulCurrentSize, REF(UINT32) ulCurrentStart);
  259.     void _RecursiveBufferCopy
  260.     (
  261. UCHAR* pucDestBuffer,
  262. IHXBuffer* pbufSource,
  263. UINT32 ulStartIndex,
  264. UINT32 ulSize
  265.     );
  266.     _CFragmentList m_frglstThis;
  267. };
  268. #endif //!_HXFGBUF_H_