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

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: riff.h,v 1.1.1.1.50.1 2004/07/09 01:55:06 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 _RIFF_H_
  50. #define _RIFF_H_
  51. #include "hxfiles.h"
  52. #include "hxengin.h"
  53. #define MAXLEVELS 64
  54. // To improve performance under the Simple File System, we restrict reads to
  55. // a maximum of this value (in the future, this should be registry based):
  56. #define MAX_READ_SIZE (1 << 16)
  57. class CRIFFResponse;
  58. typedef _INTERFACE IHXFileObject IHXFileObject;
  59. class CRIFFReader : public IHXFileResponse,
  60.             public IHXThreadSafeMethods
  61. {
  62. public:
  63.     CRIFFReader(IUnknown*, CRIFFResponse*, IHXFileObject*);
  64.     ~CRIFFReader();
  65.     // CRIFFReader methods
  66.     /*
  67.      * Open: Opens the given file for reading
  68.      */
  69.     HX_RESULT Open(char* filename);
  70.     /*
  71.      * Close: Close the file
  72.      */
  73.     HX_RESULT Close();
  74.     /* FindChunk:
  75.      * At the current level of the file, search for a chunk with the given id.
  76.      * If not relative, start at the beginning of the file.  If relative,
  77.      * Start from the beginning of next chunk (or at the current file position
  78.      * if it is already pointing at the start of a chunk)
  79.      */
  80.     HX_RESULT FindChunk(UINT32 id, BOOL bRelative);
  81.     /* Descend:
  82.      * If pointing at a list or riff chunk, begin parsing the contents
  83.      * of the list
  84.      */
  85.     HX_RESULT Descend();
  86.     /* Ascend:
  87.      * Go back up a level from a previous Descend
  88.      */
  89.     HX_RESULT Ascend();
  90.     /*
  91.      * Read:
  92.      * Read the given number of bytes from the file at the current
  93.      * position
  94.      */
  95.     HX_RESULT Read(UINT32);
  96.     /*
  97.      * Seek:
  98.      * Seek to the given position _within_the_current_chunk_.
  99.      * If relative, seek relative to the current file position.
  100.      * If not relative, seek relative to the beginning of the chunk
  101.      */
  102.     HX_RESULT Seek(UINT32, BOOL);
  103.     /*
  104.      * FileSeek:
  105.      * Seek to the absolute position in the file.  Mainly for file formats
  106.      * that store index chunks with file relative offsets.  Does not
  107.      * check to see if a chunk boundary is crossed, make sure you know
  108.      * what you're doing!
  109.      */
  110.     HX_RESULT FileSeek(UINT32);
  111.     /*
  112.      * GetChunk:
  113.      * Read an entire chunk into a buffer
  114.      */
  115.     HX_RESULT GetChunk();
  116.     UINT32  CurrentOffset() { return m_ulCurOffset - m_ulThisChunkOffset; };
  117.     UINT32  FileType();
  118.     UINT32  FileSubtype();
  119.     UINT32 m_ulFileSpecifiedReadSize;
  120.     // IHXFileResponse methods
  121.     STDMETHOD(QueryInterface) (THIS_
  122.                    REFIID riid,
  123.                    void** ppvObj);
  124.     STDMETHOD_(ULONG32,AddRef) (THIS);
  125.     STDMETHOD_(ULONG32,Release) (THIS);
  126.     STDMETHOD(InitDone)      (THIS_
  127.                   HX_RESULT status);
  128.     STDMETHOD(ReadDone)      (THIS_
  129.                   HX_RESULT status,
  130.                   IHXBuffer* pBuffer);
  131.     STDMETHOD(SeekDone)      (THIS_
  132.                   HX_RESULT status);
  133.     STDMETHOD(CloseDone)     (THIS_
  134.                   HX_RESULT status);
  135.     STDMETHOD(WriteDone)     (THIS_
  136.                   HX_RESULT status);
  137.      /************************************************************************
  138.      *  Method:
  139.      *      IHXFileResponse::FileObjectReady
  140.      *  Purpose:
  141.      *      Notification interface provided by users of the IHXFileObject
  142.      *      interface. This method is called by the IHXFileObject when the
  143.      *      requested FileObject is ready. It may return NULL with
  144.      *      HX_RESULT_FAIL if the requested filename did not exist in the
  145.      *      same pool.
  146.      */
  147.     STDMETHOD(FileObjectReady)  (THIS_
  148.                 HX_RESULT status,
  149.                 IHXFileObject* pFileObject);
  150.     STDMETHOD_(UINT32,IsThreadSafe)(THIS);
  151.     // Special getlong and getshort that can handle files in either byte
  152.     // order (depending on what file type we think we're dealing with)
  153.     INT32 GetLong(UCHAR* data)
  154.     {
  155.     if(m_bLittleEndian)
  156.         return
  157.         (INT32)((((unsigned long)data[3]) << 24) | (((unsigned long)data[2]) << 16) | (((unsigned long)data[1]) << 8) | (unsigned long)data[0]);
  158.     else
  159.         return
  160.             (INT32)((((unsigned long)data[0]) << 24) | (((unsigned long)data[1]) << 16) | (((unsigned long)data[2]) << 8) | (unsigned long)data[3]);
  161.     };
  162.     INT16 GetShort(UCHAR* data)
  163.     {
  164.     if(m_bLittleEndian)
  165.         return (data[1] << 8) | data[0];
  166.     else
  167.         return (data[0] << 8) | data[1];
  168.     };
  169.     UINT32 GetListType();
  170.     UINT32 GetOffset();
  171. private:
  172.     struct LevelInfo
  173.     {
  174.     LevelInfo()
  175.         : m_startOffset(0)
  176.         , m_nextChunkOffset(0)
  177.         , started(FALSE)
  178.     {}
  179.     UINT32 m_startOffset;
  180.     UINT32 m_nextChunkOffset;
  181.     BOOL   started;
  182.     };
  183.     INT32                 m_lRefCount;
  184.     IHXFileObject*       m_pFileObject;
  185.     CRIFFResponse*        m_pResponse;
  186.     IUnknown*             m_pContext;
  187.     BOOL                  m_bFileIsOpen;
  188.     char*                 m_pFilename;
  189.     UINT32                m_ulFindChunkId;
  190.     UINT32                m_ulChunkBodyLen;
  191.     BOOL                  m_bLittleEndian;
  192.     UINT32                m_ulLevel;
  193.     UINT32                m_ulSeekOffset;
  194.     UINT32                m_ulCurOffset;
  195.     UINT32                m_ulFileType;
  196.     UINT32                m_ulSubFileType;
  197.     UINT32                m_ulChunkType;
  198.     UINT32                m_ulChunkSubType;
  199.     LevelInfo             m_levelInfo[MAXLEVELS];
  200.     UINT32                m_ulThisChunkOffset;
  201.     UINT32                m_ulGetChunkType;
  202.     UINT32                m_ulSizeDiff;
  203.     // For chunks > MAX_READ_SIZE, our reassembly buffer and associated
  204.     // variables:
  205.     IHXBuffer*           m_pReassemblyBuffer;
  206.     UINT32                m_ulChunkBytesRead;
  207.     UINT32                m_ulChunkSize;
  208.     typedef enum
  209.     {
  210.     RS_Ready,
  211.     RS_InitPending,
  212.     RS_ChunkHeaderReadPending,
  213.     RS_FileStartSeekPending,
  214.     RS_ChunkBodySeekPending,
  215.     RS_GetFileTypePending,
  216.     RS_AscendSeekPending,
  217.     RS_GetActualFileTypePending,
  218.     RS_DataReadPending,
  219.     RS_GetListTypePending,
  220.     RS_UserSeekPending,
  221.     RS_ReadChunkHeaderPending,
  222.     RS_ReadChunkBodyPending
  223.     }
  224.     RiffState;
  225.     RiffState m_state;
  226.     HX_RESULT InternalClose();
  227. };
  228. #endif