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