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

Symbian

开发平台:

Visual C++

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