windows-nt/Source/XPSP1/NT/com/ole32/stg/h/filest.hxx

1270 lines
34 KiB
C++
Raw Normal View History

2020-09-26 03:20:57 -05:00
//+--------------------------------------------------------------
//
// Microsoft Windows
// Copyright (C) Microsoft Corporation, 1991 - 1992
//
// File: filest.hxx
//
// Contents: Windows FAT ILockBytes implementation
//
// History: 20-Nov-91 DrewB Created
//
//---------------------------------------------------------------
#ifndef __FILEST_HXX__
#define __FILEST_HXX__
#include <dfmsp.hxx>
#include <cntxlist.hxx>
#include <filelkb.hxx>
#if WIN32 >= 300
#include <accstg.hxx>
#endif
#ifdef ASYNC
#include <iconn.h>
#endif
#include <debnot.h>
DECLARE_DEBUG(filest);
#define DEB_INFO DEB_USER1 // General File Stream Information.
#define DEB_SEEK DEB_USER2 // Report all Seeks.
#define DEB_MAP DEB_USER3 // Information about the File Map.
#define DEB_MAPIO DEB_USER4 // Report all I/O via the File Map.
#define DEB_FILEIO DEB_USER5 // Report all I/O via ReadFile/WriteFile.
#define DEB_LOCK DEB_USER6 // Report all file locking.
#define fsErr(l, e) ErrJmp(filest, l, e, sc)
#define fsChkTo(l, e) if (FAILED(sc = (e))) fsErr(l, sc) else 1
#define fsHChkTo(l, e) if (FAILED(sc = DfGetScode(e))) fsErr(l, sc) else 1
#define fsHChk(e) fsHChkTo(EH_Err, e)
#define fsChk(e) fsChkTo(EH_Err, e)
#define fsMemTo(l, e) \
if ((e) == NULL) fsErr(l, STG_E_INSUFFICIENTMEMORY) else 1
#define fsMem(e) fsMemTo(EH_Err, e)
#if DBG == 1
#define filestDebugOut(x) filestInlineDebugOut x
#define filestDebug(x) filestDebugOut(x)
#define fsAssert(e) Win4Assert(e)
#define fsVerify(e) Win4Assert(e)
#define fsHVerSucc(e) Win4Assert(SUCCEEDED(DfGetScode(e)))
#else
#define filestDebug(x)
#define fsAssert(e)
#define fsVerify(e) (e)
#define fsHVerSucc(e)
#endif
#define boolChk(e) \
if (!(e)) fsErr(EH_Err, LAST_STG_SCODE) else 1
#define boolChkTo(l, e) \
if (!(e)) fsErr(l, LAST_STG_SCODE) else 1
#define negChk(e) \
if ((e) == 0xffffffff) fsErr(EH_Err, LAST_STG_SCODE) else 1
#define negChkTo(l, e) \
if ((e) == 0xffffffff) fsErr(l, LAST_STG_SCODE) else 1
// Local flags
#define LFF_RESERVE_HANDLE 1
// FILEH and INVALID_FH allow us to switch between file handle
// types for Win16/32
typedef HANDLE FILEH;
#define INVALID_FH INVALID_HANDLE_VALUE
#define CheckHandle() (_hFile == INVALID_FH ? STG_E_INVALIDHANDLE : S_OK)
#if WIN32 == 100 || WIN32 > 200
#define USE_FILEMAPPING
#endif
//
// Flags for carring around state in InitWorker and friends.
//
#define FSINIT_NORMAL 0x0000
#define FSINIT_UNMARSHAL 0x0001 // We are Unmarshaling
#define FSINIT_MADEUPNAME 0x0002 // We made-up the file name.
//+--------------------------------------------------------------
//
// Class: CFileStream (fst)
//
// Purpose: ILockBytes implementation for a file
//
// Interface: See below
//
// History: 24-Mar-92 DrewB Created
// Nov-96 BChapman Mapped files implementation.
//
//---------------------------------------------------------------
class CGlobalFileStream;
class CPerContext;
SAFE_DFBASED_PTR(CBasedGlobalFileStreamPtr, CGlobalFileStream);
interface CFileStream : public ILockBytes,
public IFileLockBytes,
public IMarshal,
#ifdef ASYNC
public IFillLockBytes,
public IFillInfo,
#endif // ASYNC
#if WIN32 >= 300
public CAccessControl,
#endif
public CContext
{
public:
CFileStream(IMalloc * const pMalloc);
#if DBG == 1 && defined(MULTIHEAP)
// This is only for global instances that do not use shared memory
void RemoveFromGlobal () { _pgfst = NULL; _cReferences = 0; };
#endif
CGlobalFileStream * GetGlobal() { return _pgfst; };
SCODE InitGlobal(DWORD dwStartFlags, DFLAGS df);
void InitFromGlobal(CGlobalFileStream *pgfst);
inline SCODE InitFile(WCHAR const *pwcsPath);
inline SCODE InitUnmarshal(void);
inline SCODE InitScratch(void);
inline SCODE InitSnapShot(void);
SCODE InitFromHandle(HANDLE h);
void InitFromFileStream (CFileStream *pfst);
~CFileStream(void);
ULONG vRelease(void);
inline void vAddRef(void);
// IUnknown
STDMETHOD(QueryInterface)(REFIID iid, void **ppvObj);
STDMETHOD_(ULONG, AddRef)(void);
STDMETHOD_(ULONG, Release)(void);
// IMarshal
STDMETHOD(GetUnmarshalClass)(REFIID riid,
LPVOID pv,
DWORD dwDestContext,
LPVOID pvDestContext,
DWORD mshlflags,
LPCLSID pCid);
STDMETHOD(GetMarshalSizeMax)(REFIID riid,
LPVOID pv,
DWORD dwDestContext,
LPVOID pvDestContext,
DWORD mshlflags,
LPDWORD pSize);
STDMETHOD(MarshalInterface)(IStream *pStm,
REFIID riid,
LPVOID pv,
DWORD dwDestContext,
LPVOID pvDestContext,
DWORD mshlflags);
STDMETHOD(UnmarshalInterface)(IStream *pStm,
REFIID riid,
LPVOID *ppv);
static SCODE StaticReleaseMarshalData(IStream *pstm,
DWORD mshlflags);
STDMETHOD(ReleaseMarshalData)(IStream *pStm);
STDMETHOD(DisconnectObject)(DWORD dwReserved);
// ILockBytes
STDMETHOD(ReadAt)(ULARGE_INTEGER ulOffset,
VOID HUGEP *pv,
ULONG cb,
ULONG *pcbRead);
STDMETHOD(WriteAt)(ULARGE_INTEGER ulOffset,
VOID const HUGEP *pv,
ULONG cb,
ULONG *pcbWritten);
STDMETHOD(Flush)(void);
STDMETHOD(SetSize)(ULARGE_INTEGER cb);
STDMETHOD(LockRegion)(ULARGE_INTEGER libOffset,
ULARGE_INTEGER cb,
DWORD dwLockType);
STDMETHOD(UnlockRegion)(ULARGE_INTEGER libOffset,
ULARGE_INTEGER cb,
DWORD dwLockType);
STDMETHOD(Stat)(STATSTG *pstatstg, DWORD grfStatFlag);
// IFileLockBytes
STDMETHOD(SwitchToFile)(OLECHAR const *ptcsFile,
#ifdef LARGE_DOCFILE
ULONGLONG ulCommitSize,
#else
ULONG ulCommitSize,
#endif
ULONG cbBuffer,
void *pvBuffer);
STDMETHOD(FlushCache)(THIS);
STDMETHOD(ReserveHandle)(void);
STDMETHOD(GetLocksSupported)(THIS_ DWORD *pdwLockFlags);
STDMETHOD(GetSize)(THIS_ ULARGE_INTEGER *puliSize);
STDMETHOD_(ULONG, GetSectorSize) (THIS);
STDMETHOD_(BOOL, IsEncryptedFile) (THIS);
#ifdef ASYNC
//IFillLockBytes
STDMETHOD(FillAppend)(void const *pv,
ULONG cb,
ULONG *pcbWritten);
STDMETHOD(FillAt)(ULARGE_INTEGER ulOffset,
void const *pv,
ULONG cb,
ULONG *pcbWritten);
STDMETHOD(SetFillSize)(ULARGE_INTEGER ulSize);
STDMETHOD(Terminate)(BOOL bCanceled);
//From IFillInfo
STDMETHOD(GetFailureInfo)(ULONG *pulWaterMark,
ULONG *pulFailurePoint);
STDMETHOD(GetTerminationStatus)(DWORD *pdwFlags);
void StartAsyncMode(void);
inline void SetContext(CPerContext *ppc);
inline CPerContext *GetContextPointer(void) const;
#endif // ASYNC
// New
SCODE GetName(WCHAR **ppwcsName);
inline ContextId GetContext(void) const;
inline CFileStream *GetNext(void) const;
inline SCODE Validate(void) const;
inline void SetStartFlags(DWORD dwStartFlags);
inline DWORD GetStartFlags(void) const;
inline DFLAGS GetFlags(void) const;
inline IMalloc *GetMalloc(void) const;
void Delete(void);
SCODE SetTime(WHICHTIME tt, TIME_T nt);
SCODE SetAllTimes(TIME_T atm, TIME_T mtm, TIME_T ctm);
static SCODE Unmarshal(IStream *pstm,
void **ppv,
DWORD mshlflags);
inline void TurnOffAllMappings(void);
inline BOOL IsHandleValid ();
private:
SCODE InitWorker(
WCHAR const *pwcsPath,
DWORD fCheck);
SCODE Init_GetNtOpenFlags(
LPDWORD pdwAccess,
LPDWORD pdwShare,
LPDWORD pdwCreation,
LPDWORD pdwFlagAttr);
SCODE Init_OpenOrCreate(
WCHAR *pwcPath,
TCHAR *ptcTmpPath,
DWORD dwFSInit);
SCODE Init_DupFileHandle(DWORD dwFSInit);
SCODE DupFileHandleToOthers(void);
#ifdef LARGE_DOCFILE
SCODE SetSizeWorker(ULONGLONG ulSize);
#else
SCODE SetSizeWorker(ULONG ulLow);
#endif
SCODE WriteAtWorker(
#ifdef LARGE_DOCFILE
ULARGE_INTEGER ulPosition,
#else
ULONG ulLow,
#endif
VOID const *pb,
ULONG cb,
ULONG *pcbWritten);
SCODE Init_GetTempName(
TCHAR *ptcPath,
TCHAR *ptcTmpPath);
SCODE ReadAt_FromFile(
#ifdef LARGE_DOCFILE
ULONGLONG iPosition,
#else
ULONG iPosition,
#endif
VOID *pb,
ULONG cb,
ULONG *pcbRead);
BOOL DeleteTheFile(const WCHAR *pwcName);
#ifdef USE_FILEMAPPING
SCODE Init_MemoryMap(DWORD dwFSinit);
SCODE MapView(SIZE_T cbViewSize,
DWORD dwPageFlags,
DWORD dwFSInit);
inline SCODE CheckMapView(ULONG cbRequested);
SCODE ExtendMapView(ULONG cbRequest);
inline SCODE MakeFileMapAddressValid(ULONG cbRequested);
SCODE MakeFileMapAddressValidWorker( ULONG cbRequested,
ULONG cbCommited);
SCODE TurnOffMapping(BOOL fFlush);
SCODE MakeFileStub(void);
inline BOOL IsFileMapped(void);
SCODE ReadAt_FromMap(
ULONG iPosition,
VOID *pb,
ULONG cb,
ULONG *pcbRead);
#else
inline SCODE Init_MemoryMap(DWORD) { return S_OK; };
inline SCODE MapView(SIZE_T, DWORD, DWORD) { return S_OK; };
inline SCODE CheckMapView(ULONG cbRequested) { return S_OK; };
inline SCODE MakeFileMapAddressValid(ULONG) { return S_OK; };
inline SCODE TurnOffMapping() { return S_OK; };
inline void TurnOffAllMappings(void) {};
inline BOOL IsFileMapped(void) { return FALSE; };
inline SCODE ReadAt_FromMap(ULONG, VOID*, ULONG, ULONG*) { return E_FAIL; };
#endif
#ifdef LARGE_DOCFILE
ULONGLONG SeekTo(ULONGLONG newPosition);
ULONGLONG GetFilePointer();
#if DBG == 1
SCODE PossibleDiskFull(ULONGLONG);
void CheckSeekPointer(void);
#else
inline SCODE PossibleDiskFull(ULONGLONG) { return S_OK; };
inline void CheckSeekPointer(void) { };
#endif
inline void SetCachedFilePointer(ULONGLONG ulPos);
inline BOOL FilePointerEqual(ULONGLONG ulPos);
#else // !LARGE_DOCFILE
DWORD SeekTo (ULONG newPosition);
DWORD GetFilePointer();
#if DBG == 1
SCODE PossibleDiskFull(ULONG);
void CheckSeekPointer(void);
#else
inline SCODE PossibleDiskFull(ULONG) { return S_OK; };
inline void CheckSeekPointer(void) { };
#endif
inline void SetCachedFilePointer(ULONG ulLowPos);
inline BOOL FilePointerEqual(ULONG ulLowPos);
#endif // LARGE_DOCFILE
CBasedGlobalFileStreamPtr _pgfst;
#ifdef ASYNC
CPerContext *_ppc;
#endif
FILEH _hFile;
FILEH _hReserved;
FILEH _hPreDuped; // other contexts can "push" dup'ed file handles here.
ULONG _sig;
LONG _cReferences;
// Floppy support
SCODE CheckIdentity(void);
BYTE _fFixedDisk;
DWORD _dwTicks;
char _achVolume[11];
DWORD _dwVolId;
IMalloc * const _pMalloc;
WORD _grfLocal;
//
// File Mapping state.
//
HANDLE _hMapObject;
LPBYTE _pbBaseAddr;
DWORD _cbViewSize;
};
#define COMMIT_BLOCK (16*1024)
#define MAPNAME_MAXLEN 32
#define MAPNAME_FORMAT L"DFMap%d-%d"
#define TEMPFILE_PREFIX TSTR("~DF")
//
// Valid states for (Set/Reset/Test)State()
//
#ifdef USE_FILEMAPPING
#define FSTSTATE_MAPPED 0x01 // Can (and is) using File Map.
#define FSTSTATE_PAGEFILE 0x02 // Map is a map over the PageFile.
#define FSTSTATE_SPILLED 0x04 // Was PAGEFILE but has been spilled.
#define FSTSTATE_DIRTY 0x08 // Has fileMapping been written to.
#endif // USE_FILEMAPPING
//+---------------------------------------------------------------------------
//
// Class: CGlobalFileStream (gfst)
//
// Purpose: Maintains context-insensitive filestream information
//
// Interface: See below
//
// History: 26-Oct-92 DrewB Created
//
//----------------------------------------------------------------------------
class CGlobalFileStream : public CContextList
{
public:
inline CGlobalFileStream(IMalloc * const pMalloc,
WCHAR const *pwcsPath,
DFLAGS df,
DWORD dwStartFlags);
DECLARE_CONTEXT_LIST(CFileStream);
void InitFromGlobalFileStream (CGlobalFileStream *pgfs);
inline BOOL HasName(void) const;
inline const WCHAR *GetName(void) const;
inline void SetName(WCHAR const *pwcsPath);
inline DFLAGS GetDFlags(void) const;
inline DWORD GetStartFlags(void) const;
inline void SetStartFlags(DWORD dwStartFlags);
#ifdef USE_FILEMAPPING
inline const WCHAR *GetMappingName(void) const;
inline void SetMappingName(WCHAR const *pszmapName);
inline ULONG GetMappedFileSize(void) const;
inline void SetMappedFileSize(ULONG cbSize);
inline ULONG GetMappedCommitSize(void) const;
inline void SetMappedCommitSize(ULONG cbSize);
inline void SetMapState(DWORD flag);
inline void ResetMapState(DWORD flag);
inline BOOL TestMapState(DWORD flag) const;
#else
// These stub out the File Mapping routines.
//
inline const WCHAR *GetMappingName(void) const { return NULL; };
inline void SetMappingName(WCHAR const *pszmapName) { };
inline ULONG GetMappedFileSize(void) const { return 0;} ;
inline void SetMappedFileSize(ULONG cbSize) {};
inline ULONG GetMappedCommitSize(void) const { return 0;} ;
inline void SetMappedCommitSize(ULONG cbSize) {};
inline void SetMapState(DWORD) {};
inline void ResetMapState(DWORD) {};
inline BOOL TestMapState(DWORD) const { return FALSE; };
#endif
inline IMalloc *GetMalloc(VOID) const;
inline CFileStream *GetFirstContext() const;
#ifdef LARGE_DOCFILE
inline void SetCachedFilePointer(ULONGLONG llPos);
inline BOOL FilePointerEqual(ULONGLONG llPos);
#if DBG == 1
void CheckSeekPointer(ULONGLONG ulChk);
#endif
#else
inline void SetCachedFilePointer(ULONG ulLowPos);
inline BOOL FilePointerEqual(ULONG ulLowPos);
#if DBG == 1
void CheckSeekPointer(DWORD ulLowChk);
#endif
#endif // LARGE_DOCFILE
#ifdef ASYNC
inline DWORD GetTerminationStatus(void) const;
#ifdef LARGE_DOCFILE
inline ULONGLONG GetHighWaterMark(void) const;
inline ULONGLONG GetFailurePoint(void) const;
#else
inline ULONG GetHighWaterMark(void) const;
inline ULONG GetFailurePoint(void) const;
#endif
inline void SetTerminationStatus(DWORD dwTerminate);
#ifdef LARGE_DOCFILE
inline void SetHighWaterMark(ULONGLONG ulHighWater);
inline void SetFailurePoint(ULONGLONG ulFailure);
#else
inline void SetHighWaterMark(ULONG ulHighWater);
inline void SetFailurePoint(ULONG ulFailure);
#endif
#endif
inline ULONG GetSectorSize ();
inline void SetSectorSize (ULONG cbSector);
private:
DFLAGS _df;
DWORD _dwStartFlags;
IMalloc * const _pMalloc;
// Cache the current seek Position to save on calls to SetFilePointer
// on Windows95. (We are using an "Overlapped" structure on NT).
// We are duping the file handles on marshaling, so the current seek
// position is shared.
#ifdef LARGE_DOCFILE
ULONGLONG _ulPos;
#else
// NOTE: We rely on the fact that we never pass in a high dword other
// than zero. We only cache the low dword of the seek pointer.
ULONG _ulLowPos;
#endif
ULONG _cbSector;
#ifdef USE_FILEMAPPING
DWORD _cbMappedFileSize;
DWORD _cbMappedCommitSize;
DWORD _dwMapFlags;
WCHAR _awcMapName[MAPNAME_MAXLEN];
#endif
WCHAR _awcPath[_MAX_PATH+1];
#ifdef ASYNC
DWORD _dwTerminate;
#ifdef LARGE_DOCFILE
ULONGLONG _ulHighWater;
ULONGLONG _ulFailurePoint;
#else
ULONG _ulHighWater;
ULONG _ulFailurePoint;
#endif // LARGE_DOCFILE
#endif // ASYNC
#if DBG == 1
#ifdef LARGE_DOCFILE
ULONGLONG _ulLastFilePos;
#else
ULONG _ulLastFilePos;
#endif // LARGE_DOCFILE
#endif
};
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::CGlobalFileStream, public
//
// Synopsis: Constructor
//
// Arguments: [pszPath] - Path
// [df] - Permissions
// [dwStartFlags] - Startup flags
//
// History: 27-Oct-92 DrewB Created
// 18-May-93 AlexT Added pMalloc
//
//----------------------------------------------------------------------------
inline CGlobalFileStream::CGlobalFileStream(IMalloc * const pMalloc,
WCHAR const *pwcsPath,
DFLAGS df,
DWORD dwStartFlags)
: _pMalloc(pMalloc)
{
SetName(pwcsPath);
_df = df;
_dwStartFlags = dwStartFlags;
#ifdef USE_FILEMAPPING
SetMappingName(NULL);
_cbMappedFileSize = 0;
_cbMappedCommitSize = 0;
_dwMapFlags = 0;
#endif
#ifdef ASYNC
_dwTerminate = TERMINATED_NORMAL;
_ulHighWater = _ulFailurePoint = 0;
#endif
#ifdef LARGE_DOCFILE
_ulPos = MAX_ULONGLONG; // 0xFFFFFFFFFFFFFFFF
#if DBG == 1
_ulLastFilePos = MAX_ULONGLONG; // 0xFFFFFFFFFFFFFFFF
#endif
#else
_ulLowPos = 0xFFFFFFFF;
#if DBG == 1
_ulLastFilePos = 0xFFFFFFFF;
#endif
#endif
_cbSector = HEADERSIZE;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::HasName, public
//
// Synopsis: Checks for a name
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline BOOL CGlobalFileStream::HasName(void) const
{
return (BOOL)_awcPath[0];
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetName, public
//
// Synopsis: Returns the name
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline WCHAR const *CGlobalFileStream::GetName(void) const
{
return (WCHAR *) _awcPath;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetDFlags, public
//
// Synopsis: Returns the flags
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline DFLAGS CGlobalFileStream::GetDFlags(void) const
{
return _df;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetStartFlags, public
//
// Synopsis: Returns the start flags
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline DWORD CGlobalFileStream::GetStartFlags(void) const
{
return _dwStartFlags;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::SetName, public
//
// Synopsis: Sets the name
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline void CGlobalFileStream::SetName(WCHAR const *pwcsPath)
{
if (NULL != pwcsPath)
lstrcpyW(_awcPath, pwcsPath);
else
_awcPath[0] = 0;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::SetStartFlags, public
//
// Synopsis: Sets the start flags
//
// History: 13-Jan-93 DrewB Created
//
//----------------------------------------------------------------------------
inline void CGlobalFileStream::SetStartFlags(DWORD dwStartFlags)
{
_dwStartFlags = dwStartFlags;
}
#ifdef USE_FILEMAPPING
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetMappingName, private
// Member: CGlobalFileStream::SetMappingName, private
//
// Synopsis: Returns/Sets the name of the file mapping object.
//
// History: 13-Jan-1997 BChapman Created
//
//----------------------------------------------------------------------------
inline const WCHAR *CGlobalFileStream::GetMappingName(void) const
{
if(0 != _awcMapName[0])
return (WCHAR *) _awcMapName;
else
return NULL;
}
inline void CGlobalFileStream::SetMappingName(WCHAR const *pwcMapName)
{
if(NULL != pwcMapName)
lstrcpy(_awcMapName, pwcMapName);
else
_awcMapName[0] = 0;
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetMappedFileSize, private
// CGlobalFileStream::SetMappedFileSize, private
//
// Synopsis: Returns/Sets the size of a file that is mapped. We need
// this because SetEndOfFile cannot be called when a mapping
// exists. We need to track the "logical" EOF and set it when
// we flush and close the mapping.
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline ULONG CGlobalFileStream::GetMappedFileSize(void) const
{
return _cbMappedFileSize;
}
inline void CGlobalFileStream::SetMappedFileSize(ULONG cbFileSize)
{
_cbMappedFileSize = cbFileSize;
filestDebug((DEB_MAP,"GblFilest: StoreFileSize 0x%06x of '%ws'\n",
cbFileSize, _awcPath));
}
//+---------------------------------------------------------------------------
//
// Member: CGlobalFileStream::GetMappedCommitSize, private
// CGlobalFileStream::SetMappedCommitSize, private
//
// Synopsis: Returns/Sets the commed size of a file mapping. We use
// this to decide if we should call VirtualAlloc().
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline ULONG CGlobalFileStream::GetMappedCommitSize(void) const
{
return _cbMappedCommitSize;
}
inline void CGlobalFileStream::SetMappedCommitSize(ULONG cbCommitSize)
{
_cbMappedCommitSize = cbCommitSize;
filestDebug((DEB_MAP,"GblFilest: StoreCommitSize 0x%06x of '%ws'\n",
cbCommitSize, _awcPath));
}
//+---------------------------------------------------------------------------
//
// Member:
// CGlobalFileStream::SetMapState, private
// CGlobalFileStream::ResetMapState, private
// CGlobalFileStream::TestMapState, private
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline void CGlobalFileStream::SetMapState(DWORD flag)
{
_dwMapFlags |= flag;
}
inline void CGlobalFileStream::ResetMapState(DWORD flag)
{
_dwMapFlags &= ~flag;
}
inline BOOL CGlobalFileStream::TestMapState(DWORD flag) const
{
return(flag & _dwMapFlags);
}
#endif // USE_FILEMAPPING
#ifdef ASYNC
inline DWORD CGlobalFileStream::GetTerminationStatus(void) const
{
return _dwTerminate;
}
#ifdef LARGE_DOCFILE
inline ULONGLONG CGlobalFileStream::GetHighWaterMark(void) const
#else
inline ULONG CGlobalFileStream::GetHighWaterMark(void) const
#endif
{
return _ulHighWater;
}
#ifdef LARGE_DOCFILE
inline ULONGLONG CGlobalFileStream::GetFailurePoint(void) const
#else
inline ULONG CGlobalFileStream::GetFailurePoint(void) const
#endif
{
return _ulFailurePoint;
}
inline void CGlobalFileStream::SetTerminationStatus(DWORD dwTerminate)
{
fsAssert((dwTerminate == UNTERMINATED) ||
(dwTerminate == TERMINATED_NORMAL) ||
(dwTerminate == TERMINATED_ABNORMAL));
_dwTerminate = dwTerminate;
}
#ifdef LARGE_DOCFILE
inline void CGlobalFileStream::SetHighWaterMark(ULONGLONG ulHighWater)
#else
inline void CGlobalFileStream::SetHighWaterMark(ULONG ulHighWater)
#endif
{
fsAssert(ulHighWater >= _ulHighWater);
_ulHighWater = ulHighWater;
}
#ifdef LARGE_DOCFILE
inline void CGlobalFileStream::SetFailurePoint(ULONGLONG ulFailure)
#else
inline void CGlobalFileStream::SetFailurePoint(ULONG ulFailure)
#endif
{
_ulFailurePoint = ulFailure;
}
#endif //ASYNC
//+--------------------------------------------------------------
//
// Member: CGlobalFileStream::GetMalloc, public
//
// Synopsis: Returns the allocator associated with this global file
//
// History: 05-May-93 AlexT Created
//
//---------------------------------------------------------------
inline IMalloc *CGlobalFileStream::GetMalloc(VOID) const
{
return(_pMalloc);
}
#define CFILESTREAM_SIG LONGSIG('F', 'L', 'S', 'T')
#define CFILESTREAM_SIGDEL LONGSIG('F', 'l', 'S', 't')
//+--------------------------------------------------------------
//
// Member: CGlobalFileStream::GetFirstContext, public
//
// Synopsis: Returns the head of the context list
//
// History: 16-apr-97 BChapman created
//
//---------------------------------------------------------------
inline CFileStream *CGlobalFileStream::GetFirstContext(VOID) const
{
return(GetHead());
}
//+--------------------------------------------------------------
//
// Member: CGlobalFileStream::SetCachedFilePointer, public
// CGlobalFileStream::FilePointerEqual, public
//
// Synopsis: Maintain the cached file pointer. To Reduce the number
// of calls to SetFilePointer.
//
// History: 16-apr-97 BChapman created
//
//---------------------------------------------------------------
#ifdef LARGE_DOCFILE
inline void CGlobalFileStream::SetCachedFilePointer(ULONGLONG ulPos)
{
_ulPos = ulPos;
}
inline BOOL CGlobalFileStream::FilePointerEqual(ULONGLONG ulPos)
{
return(ulPos == _ulPos);
}
#else
inline void CGlobalFileStream::SetCachedFilePointer(DWORD ulLowPos)
{
_ulLowPos = ulLowPos;
}
inline BOOL CGlobalFileStream::FilePointerEqual(DWORD ulLow)
{
return(ulLow == _ulLowPos);
}
#endif
//+--------------------------------------------------------------
//
// Member: CGlobalFileStream::SetSectorSize
// CGlobalFileStream::GetSectorSize, public
//
// Synopsis: gets and sets the physical sector size for the file's volume
//
// History: 04-Dec-98 HenryLee created
//
//---------------------------------------------------------------
ULONG CGlobalFileStream::GetSectorSize ()
{
return _cbSector;
}
void CGlobalFileStream::SetSectorSize (ULONG cbSector)
{
_cbSector = cbSector;
}
//+--------------------------------------------------------------
//
// Member: CFileStream::SetCachedFilePointer, public
// CFileStream::FilePointerEqual, public
//
// Synopsis: Maintain the cached file pointer. To Reduce the number
// of calls to SetFilePointer.
//
// History: 16-apr-97 BChapman created
//
//---------------------------------------------------------------
#ifdef LARGE_DOCFILE
inline void CFileStream::SetCachedFilePointer(ULONGLONG ulPos)
#else
inline void CFileStream::SetCachedFilePointer(DWORD ulLowPos)
#endif
{
if(_pgfst == NULL)
{
filestDebug((DEB_SEEK, "File=%2x SetCachedFilePointer has no global "
"file stream.", _hFile));
return;
}
#ifdef LARGE_DOCFILE
_pgfst->SetCachedFilePointer(ulPos);
#else
_pgfst->SetCachedFilePointer(ulLowPos);
#endif
CheckSeekPointer();
}
#ifdef LARGE_DOCFILE
inline BOOL CFileStream::FilePointerEqual(ULONGLONG ulPos)
#else
inline BOOL CFileStream::FilePointerEqual(DWORD ulLow)
#endif
{
if(_pgfst == NULL)
{
filestDebug((DEB_SEEK, "File=%2x FilePointerEqual has no global "
"file stream.", _hFile));
// Always Seek
return FALSE;
}
CheckSeekPointer();
#ifdef LARGE_DOCFILE
return _pgfst->FilePointerEqual(ulPos);
#else
return _pgfst->FilePointerEqual(ulLow);
#endif
}
//+--------------------------------------------------------------
//
// Member: CFileStream::Validate, public
//
// Synopsis: Validates the class signature
//
// Returns: Returns STG_E_INVALIDHANDLE for failure
//
// History: 20-Jan-92 DrewB Created
//
//---------------------------------------------------------------
inline SCODE CFileStream::Validate(void) const
{
return (this == NULL || _sig != CFILESTREAM_SIG) ?
STG_E_INVALIDHANDLE : S_OK;
}
//+--------------------------------------------------------------
//
// Member: CFileStream::AddRef, public
//
// Synopsis: Changes the ref count
//
// History: 26-Feb-92 DrewB Created
//
//---------------------------------------------------------------
inline void CFileStream::vAddRef(void)
{
InterlockedIncrement(&_cReferences);
}
//+--------------------------------------------------------------
//
// Member: CFileStream::GetContext, public
//
// Synopsis: Returns the task ID.
//
// History: 24-Sep-92 PhilipLa Created
//
//---------------------------------------------------------------
inline ContextId CFileStream::GetContext(void) const
{
return ctxid;
}
//+---------------------------------------------------------------------------
//
// Member: CFileStream::GetNext, public
//
// Synopsis: Returns the next filestream in the context list
//
// History: 27-Oct-92 DrewB Created
//
//----------------------------------------------------------------------------
inline CFileStream *CFileStream::GetNext(void) const
{
return (CFileStream *) (CContext *) pctxNext;
}
//+--------------------------------------------------------------
//
// Member: CFileStream::SetStartFlags, public
//
// Synopsis: Sets the start flags
//
// History: 31-Aug-92 DrewB Created
//
//---------------------------------------------------------------
inline void CFileStream::SetStartFlags(DWORD dwStartFlags)
{
_pgfst->SetStartFlags(dwStartFlags);
}
//+---------------------------------------------------------------------------
//
// Member: CFileStream::Init*, public
//
// Synopsis: Wrapper functions - call through to InitWorker
//
// History: 15-Jan-97 BChapman Created
//
//----------------------------------------------------------------------------
inline SCODE CFileStream::InitFile(WCHAR const *pwcsPath)
{
fsAssert(!(GetStartFlags() & RSF_TEMPFILE));
return InitWorker(pwcsPath, FSINIT_NORMAL);
}
inline SCODE CFileStream::InitScratch()
{
fsAssert(GetStartFlags() & RSF_SCRATCH);
fsAssert(GetStartFlags() & RSF_DELETEONRELEASE);
return InitWorker(NULL, FSINIT_NORMAL);
}
inline SCODE CFileStream::InitSnapShot()
{
fsAssert(GetStartFlags() & RSF_SNAPSHOT);
fsAssert(GetStartFlags() & RSF_DELETEONRELEASE);
return InitWorker(NULL, FSINIT_NORMAL);
}
inline SCODE CFileStream::InitUnmarshal()
{
return InitWorker(NULL, FSINIT_UNMARSHAL);
}
inline DWORD CFileStream::GetStartFlags(void) const
{
return _pgfst->GetStartFlags();
}
inline DFLAGS CFileStream::GetFlags(void) const
{
return _pgfst->GetDFlags();
}
inline IMalloc * CFileStream::GetMalloc(void) const
{
return _pgfst->GetMalloc();
}
#ifdef USE_FILEMAPPING
//+---------------------------------------------------------------------------
//
// Member: CFileStream::IsFileMapped, private
//
// Synopsis: Check if the file memory mapped. This also shuts down an
// an existing map if the global object tells it to.
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline BOOL CFileStream::IsFileMapped()
{
//
// If we don't have a map pointer then it is not mapped.
//
if (NULL == _pbBaseAddr)
return FALSE;
//
// If we were mapped but the global state says STOP then someone
// else has closed the file mapping and we should do the same.
//
if( ! _pgfst->TestMapState(FSTSTATE_MAPPED))
{
TurnOffMapping(TRUE);
return FALSE;
}
return TRUE;
}
//+---------------------------------------------------------------------------
//
// Member: CFileStream::TurnOffAllMappings, private
//
// Synopsis: Turn off our file mapping. Then tell the global object that
// we want everyone else to give up their mappings. They will
// notice this in IsFileMapped and shut down then.
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline void CFileStream::TurnOffAllMappings()
{
TurnOffMapping(FALSE);
_pgfst->ResetMapState(FSTSTATE_MAPPED);
}
//+---------------------------------------------------------------------------
//
// Member: CFileStream::CheckMapView, private
//
// Synopsis: This inline routine prevents us from making a 'real'
// function call every time we might use the memory mapped
// file.
//
// History: 20-Feb-1997 BChapman Created
//
//----------------------------------------------------------------------------
inline SCODE CFileStream::CheckMapView(ULONG cbRequested)
{
if(cbRequested > _cbViewSize)
return ExtendMapView(cbRequested);
return S_OK;
}
//+---------------------------------------------------------------------------
//
// Member: CFileStream::MakeFileMapAddressValid, private
//
// Synopsis: This inline routine prevents us from making a 'real'
// function call every time we might use the memory mapped
// file.
//
// History: 01-Nov-96 BChapman Created
//
//----------------------------------------------------------------------------
inline SCODE CFileStream::MakeFileMapAddressValid(ULONG cbRequested)
{
if (IsFileMapped())
{
ULONG cbCommitSize = _pgfst->GetMappedCommitSize();
if(cbRequested > cbCommitSize)
return MakeFileMapAddressValidWorker(cbRequested, cbCommitSize);
else
return CheckMapView(cbRequested);
}
return STG_E_INVALIDHANDLE;
}
#endif // USE_FILEMAPPING
#ifdef ASYNC
inline CPerContext * CFileStream::GetContextPointer(void) const
{
return _ppc;
}
inline void CFileStream::SetContext(CPerContext *ppc)
{
_ppc = ppc;
}
#endif //ASYNC
inline ULONG CFileStream::GetSectorSize ()
{
return _pgfst->GetSectorSize();
}
inline BOOL CFileStream::IsHandleValid ()
{
BOOL fValid = TRUE;
if (_hFile != INVALID_FH &&
GetFileType(_hFile) != FILE_TYPE_DISK)
{
fValid = FALSE;
ctxid = 0; // don't let anyone find this context again
}
return fValid;
}
#endif