chxfgbuf.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:9k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: chxfgbuf.h,v 1.1.1.1.50.3 2004/07/09 01:45:51 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  49. #ifndef _HXFGBUF_H_
  50. #define _HXFGBUF_H_
  51. /*
  52.  * IHXFragmentedBuffer
  53.  *     STDMETHOD(GetEnumerator)(REF(IEnumHXFragmentedBuffer *));
  54.  *     STDMETHOD(Prepend)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  55.  *     STDMETHOD(Append)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  56.  *     STDMETHOD(Insert)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom, UINT32 ulStartTo);
  57.  *     STDMETHOD(Replace)(IHXBuffer *pBufferFrom, UINT32 ulStartFrom, UINT32 ulLengthFrom, UINT32 ulStartTo);
  58.  *     STDMETHOD(Get)(UINT32 ulStartFrom, UINT32 ulLengthFrom, REF(UCHAR*) pData, REF(UINT32) ulLength);
  59.  *     STDMETHOD_(UCHAR*, GetBuffer)(UINT32 ulStartFrom, UINT32 ulLengthFrom);
  60.  *
  61.  * IEnumHXFragmentedBuffer
  62.  *     STDMETHOD(Reset)();
  63.  *     STDMETHOD(Next)(UINT32 ulRequested, IHXBuffer *[]arrpbufReturned, REF(UINT32) ulReturned);
  64.  *     STDMETHOD(Skip)(UINT32 ulNumToSkip);
  65.  *     STDMETHOD(Clone)(REF(IEnumHXFragmentedBuffer *)ppefbufClone);
  66.  */
  67. #include "hxtypes.h"
  68. #include "unkimp.h"
  69. #include "ihxfgbuf.h"
  70. #include "hxbuffer.h"
  71. #include "arrenum.h"
  72. DECLARE_INTERFACE_ARRAY_ENUMERATOR(IHXBuffer, IHXEnumFragmentedBuffer);
  73.     /*
  74.      * This class is to allow fragment(s) to be
  75.      * inserted into the middle of existing buffers
  76.      * without re-copying the bytes.
  77.      *
  78.      * Before:
  79.      *     ...
  80.      *     IHXBuffer[100]
  81.      *     ...
  82.      *
  83.      * After:
  84.      *     ...
  85.      *     (_CBufferFragment(0,20))IHXBuffer[20]----
  86.      *     (New)IHXBuffer[43]        -->IHXBuffer[100]
  87.      *     (_CBufferFragment(21,80)IHXBuffer[80]----/
  88.      *     ...
  89.      *
  90.      * XXX Optimize by overriding the new operator.
  91.      *
  92.      * The local implementation should maintain a 
  93.      * static array of BufferFragment arrays 
  94.      * (BufferFragment[n][32]), and return the next 
  95.      * free one.
  96.      * When all BFs are in use, the first dimension
  97.      * should be re-alloced to twice it's size
  98.      * (BufferFragment*[n*2]). The existing pointers 
  99.      * are then copied into it.  A new block
  100.      * of memory to cover the second dimension of 
  101.      * each of the new locations in the first dimension
  102.      * is alloced, (BufferFragment[n*32])
  103.      * then its contents are distrubuted to the first 
  104.      * array.
  105.      * 
  106.      * This has several benefits: 
  107.      * - not copying the data around when growing.
  108.      * - Balancing allocs with wasted space.
  109.      * - Not allocing for every new object.
  110.      * - Fixed second dimension keeps management simple.
  111.      */
  112. class _CBufferFragment
  113.     : public IHXBuffer
  114.     , public CUnknownIMP
  115. {
  116.     DECLARE_UNKNOWN(_CBufferFragment)
  117. public:
  118.     _CBufferFragment()
  119. : m_pData(NULL)
  120. , m_ulStart(0)
  121. , m_ulLength(0)
  122.     {}
  123.     ~_CBufferFragment()
  124.     {HX_RELEASE(m_pData); m_ulStart=0; m_ulLength=0;}
  125.     _CBufferFragment* _SetBuffer(IHXBuffer* pData, UINT32 ulStart, UINT32 ulLength);
  126.     STDMETHOD(Set)(const UCHAR* pData, UINT32 ulLength);
  127.     STDMETHOD(Get)(REF(UCHAR*) pData, REF(UINT32) ulLength);
  128.     STDMETHOD(SetSize)(UINT32 ulLength);
  129.     STDMETHOD_(UINT32, GetSize)();
  130.     STDMETHOD_(UCHAR*, GetBuffer)();
  131. private:
  132.     IHXBuffer* m_pData;
  133.     UINT32 m_ulStart, m_ulLength;
  134. };
  135. class CHXFragmentedBuffer
  136.     : public IHXFragmentedBuffer
  137.     , public IHXBuffer
  138.     , public CUnknownIMP
  139. {
  140.     DECLARE_UNKNOWN(CHXFragmentedBuffer)
  141. private:
  142.     class _CFragment;
  143.     class _CFragmentList;
  144.     friend class _CFragment;
  145.     friend class _CFragmentList;
  146.     /* This class implements the listnodes of fragments
  147.      */
  148.     class _CFragment
  149.     {
  150.     public:
  151. inline _CFragment* Prev(){return m_pPrev;}
  152. inline _CFragment* Next(){return m_pNext;}
  153. _CFragment* SetData(IHXBuffer* pData);
  154. _CFragment* SetData(IHXBuffer* pData, UINT32 ulStartFrom, UINT32 ulLengthFrom);
  155. inline IHXBuffer* GetData(){return m_pData;}
  156. _CFragment* Insert(_CFragment* pNewPrev);
  157. _CFragment* Append(_CFragment* pNewNext);
  158. _CFragment* Remove();
  159. _CFragment():m_pData(NULL),m_pPrev(NULL),m_pNext(NULL){}
  160. ~_CFragment()
  161. {
  162.     HX_RELEASE(m_pData); 
  163.     if(m_pNext)
  164.     {
  165. m_pNext->_SetPrev(m_pPrev);
  166.     }
  167.     if(m_pPrev)
  168.     {
  169. m_pPrev->_SetNext(m_pNext);
  170.     }
  171. }
  172.     private:
  173. inline void _SetPrev(_CFragment* pfrgNew){m_pPrev = pfrgNew;}
  174. inline void _SetNext(_CFragment* pfrgNew){m_pNext = pfrgNew;}
  175. IHXBuffer* m_pData;
  176. _CFragment* m_pPrev;
  177. _CFragment* m_pNext;
  178.     };
  179.     /* This class maintains the First and Last pointers
  180.      * for a list of fragments
  181.      */
  182.     class _CFragmentList
  183.     {
  184.     public:
  185. _CFragmentList()
  186.     : m_pfrgListStart(NULL)
  187.     , m_pfrgListEnd(NULL)
  188.     , m_ulTotal(0)
  189. {}
  190. ~_CFragmentList()
  191. {
  192.     m_pfrgListEnd = NULL; 
  193.     while(m_pfrgListStart)
  194.     {
  195. m_pfrgListStart=m_pfrgListStart->Remove();
  196.     }
  197. }
  198. inline _CFragment* First(){return m_pfrgListStart;}
  199. inline _CFragment* Last(){return m_pfrgListEnd;}
  200. void Remove(_CFragment* pfrgObsolete);
  201. void Insert(_CFragment* pfrgNew, _CFragment* pfrgRelative = NULL);
  202. void Append(_CFragment* pfrgNew, _CFragment* pfrgRelative = NULL);
  203. inline UINT32 GetTotal(){return m_ulTotal;}
  204.     private:
  205. _CFragment* m_pfrgListStart;
  206. _CFragment* m_pfrgListEnd;
  207. UINT32      m_ulTotal;
  208.     };
  209. public:
  210.     CHXFragmentedBuffer()
  211.     {}
  212.     ~CHXFragmentedBuffer(){}
  213.     /* IHXFragmentedBuffer Methods
  214.      */
  215.     STDMETHOD(GetEnumerator)
  216.     (
  217. THIS_ 
  218. IHXEnumFragmentedBuffer** ppefbNewEnum
  219.     );
  220.     STDMETHOD(Prepend)
  221.     (
  222. THIS_ 
  223. IHXBuffer* pBufferFrom, 
  224. ULONG32 ulStartFrom, 
  225. ULONG32 ulLengthFrom
  226.     );
  227.     STDMETHOD(Append)
  228.     (
  229. THIS_ 
  230. IHXBuffer* pBufferFrom, 
  231. ULONG32 ulStartFrom, 
  232. ULONG32 ulLengthFrom
  233.     );
  234.     STDMETHOD(Insert)
  235.     (
  236. THIS_ 
  237. IHXBuffer* pBufferFrom, 
  238. ULONG32 ulStartFrom, 
  239. ULONG32 ulLengthFrom, 
  240. ULONG32 ulStartTo
  241.     );
  242.     STDMETHOD(Replace)
  243.     (
  244. THIS_ 
  245. IHXBuffer* pBufferFrom, 
  246. ULONG32 ulStartFrom, 
  247. ULONG32 ulLengthFrom, 
  248. ULONG32 ulStartTo
  249.     );
  250.     STDMETHOD(Get)
  251.     (
  252. THIS_ 
  253. ULONG32 ulStartFrom, 
  254. ULONG32 ulLengthFrom, 
  255. REF(UCHAR*) pData, 
  256. REF(ULONG32) ulLength
  257.     );
  258.     STDMETHOD_(UCHAR*, GetBuffer)
  259.     (
  260. THIS_ 
  261. ULONG32 ulStartFrom, 
  262. ULONG32 ulLengthFrom
  263.     );
  264.     /* IHXBuffer Methods
  265.      */ 
  266.     STDMETHOD(Set)(const UCHAR* pData, ULONG32 ulLength);
  267.     STDMETHOD(Get)(REF(UCHAR*) pData, REF(ULONG32) ulLength);
  268.     STDMETHOD(SetSize)(ULONG32 ulLength);
  269.     STDMETHOD_(ULONG32, GetSize)();
  270.     STDMETHOD_(UCHAR*, GetBuffer)();
  271. private:
  272.     STDMETHOD(_FindFragment)(UINT32 ulFindIndex, REF(_CFragment*) pfrgCurrent, REF(UINT32) ulCurrentSize, REF(UINT32) ulCurrentStart);
  273.     void _RecursiveBufferCopy
  274.     (
  275. UCHAR* pucDestBuffer,
  276. IHXBuffer* pbufSource,
  277. UINT32 ulStartIndex,
  278. UINT32 ulSize
  279.     );
  280.     _CFragmentList m_frglstThis;
  281. };
  282. #endif //!_HXFGBUF_H_