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

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 _CIHX2CHX_H_
  36. #define _CIHX2CHX_H_
  37. /************************************************************************
  38.  *  Includes
  39.  */
  40. #include "hxcom.h"
  41. #include "hxdataf.h"
  42. class CHXDataFile;
  43. /************************************************************************
  44.  *  CIHX2CHXDataFile
  45.  */
  46. class CIHX2CHXDataFile : public IHXDataFile
  47. {
  48. public:
  49. /*
  50.  *  Constructor
  51.  */
  52. CIHX2CHXDataFile(UINT32 ulFlags = 0, IUnknown** ppCommonObj = NULL);
  53. /*
  54.  *  IHXDataFile methods
  55.  */
  56. /* Bind DataFile Object with FileName */
  57. STDMETHOD_(void, Bind) (THIS_
  58. const char* FileName);
  59. /* Creates a datafile using the specified mode
  60.  * uOpenMode --- File Open mode - HX_FILE_READ/HX_FILE_WRITE/HX_FILE_BINARY
  61.  */
  62. STDMETHOD(Create) (THIS_
  63. UINT16 uOpenMode);
  64. /* Open will open a file with the specified mode
  65.  */
  66. STDMETHOD(Open) (THIS_
  67. UINT16 uOpenMode);
  68. /* Close closes a file 
  69.  * If the reference count on the IHXDataFile object is greater than 1, 
  70.  * then the underlying file cannot be safely closed, so Close() becomes 
  71.  * a noop in that case. Close it only when the object is destroyed. 
  72.  * This would be safe, but could lead to a file descriptor leak.
  73.  */
  74. STDMETHOD(Close) (THIS);
  75. /* Name returns the currently bound file name in FileName.
  76.  * and returns TRUE, if the a name has been bound.  Otherwise
  77.  * FALSE is returned.
  78.  */
  79. STDMETHOD_(BOOL, Name) (THIS_
  80. REF(IHXBuffer*) pFileName);
  81. /*
  82.  * IsOpen returns TRUE if file is open.  Otherwise FALSE.
  83.  */
  84. STDMETHOD_(BOOL, IsOpen) (THIS);
  85. /* Seek moves the current file position to the offset from the
  86.  * fromWhere specifier returns current position of file or -1 on
  87.  * error.
  88.  */
  89. STDMETHOD(Seek) (THIS_
  90. ULONG32 offset, UINT16 fromWhere);
  91. /* Tell returns the current file position in the file */
  92. STDMETHOD_(ULONG32, Tell) (THIS);
  93. /* Read reads up to count bytes of data into buf.
  94.  * returns the number of bytes read, EOF, or -1 if the read failed 
  95.  */
  96. STDMETHOD_(ULONG32, Read) (THIS_
  97. REF(IHXBuffer*) pBuf, 
  98. ULONG32 count);
  99. /* Write writes up to count bytes of data from buf.
  100.  * returns the number of bytes written, or -1 if the write failed 
  101.  */
  102. STDMETHOD_(ULONG32, Write) (THIS_
  103. REF(IHXBuffer*) pBuf); 
  104. /* Flush out the data in case of buffered I/O
  105.  */
  106. STDMETHOD(Flush) (THIS);
  107. /*
  108.  * Return info about the data file such as permissions, time of creation
  109.  * size in bytes, etc.
  110.  */
  111. STDMETHOD(Stat) (THIS_
  112. struct stat* buffer);
  113. /* Delete File */
  114. STDMETHOD(Delete) (THIS);
  115. /* Return the file descriptor */
  116. STDMETHOD_(INT16, GetFd) (THIS);
  117. /* GetLastError returns the platform specific file error */
  118. STDMETHOD(GetLastError) (THIS);
  119. /* GetLastError returns the platform specific file error in
  120.  * string form.
  121.  */
  122. STDMETHOD_(void, GetLastError) (THIS_
  123. REF(IHXBuffer*) err);
  124. /*
  125.  *  CIHX2CHXDataFile methods
  126.  */
  127. CHXDataFile* GetCHXDataFile(void) { return m_pCHXFile; }
  128. /*
  129.  *  IUnknown methods
  130.  */
  131. STDMETHOD(QueryInterface) (THIS_
  132. REFIID riid,
  133. void** ppvObj);
  134. STDMETHOD_(ULONG32, AddRef) (THIS);
  135. STDMETHOD_(ULONG32, Release) (THIS);
  136. private:
  137. /*
  138.  *  Destructor
  139.  */
  140. virtual ~CIHX2CHXDataFile(void);
  141. /*
  142.  *  Private methods
  143.  */
  144. inline UINT16 TranslateMode(UINT16 uOpenMode);
  145. CHXDataFile* m_pCHXFile;
  146. IHXBuffer* m_pFileName;
  147. BOOL m_bOpen;
  148. LONG32 m_lRefCount;
  149. PRIVATE_DESTRUCTORS_ARE_NOT_A_CRIME
  150. };
  151. #endif // _CHXDATAFILE_H_