sl@0: // Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of the License "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // f32\sfat32\inc\sl_facache32.h
sl@0: // FAT32 various cache classes definition
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @file
sl@0:  @internalTechnology
sl@0: */
sl@0: 
sl@0: #ifndef SL_FAT_CACHE_32_INL
sl@0: #define SL_FAT_CACHE_32_INL
sl@0: 
sl@0: 
sl@0: //-----------------------------------------------------------------------------
sl@0: 
sl@0: 
sl@0: void CFatBitCache::SetState(CFatBitCache::TState aState) 
sl@0:     {
sl@0:     iState = aState;
sl@0:     }
sl@0: 
sl@0: /**
sl@0:     Converts FAT index to the corresponding bit array bit number (or FAT cache sector number).
sl@0:     @param  aFatIndex index in the FAT 
sl@0:     @return corresponding index in the FAT bit array
sl@0: */
sl@0: TUint32 CFatBitCache::FatIndexToCacheSectorNumber(TUint32 aFatIndex) const
sl@0:     {
sl@0:     ASSERT(aFatIndex >= KFatFirstSearchCluster);
sl@0:     return (aFatIndex >> iFatIdxToSecCoeff);
sl@0:     }
sl@0: 
sl@0: /**
sl@0:     Converts FAT32 cache sector number to the FAT32 entry index (in the beginning of this cache sector)
sl@0:     @param  aCacheSecNum index in the FAT bit array (or FAT cache sector number)
sl@0:     @return corresponding index in the FAT 
sl@0: 
sl@0: */
sl@0: TUint32 CFatBitCache::CacheSectorNumberToFatIndex(TUint32 aCacheSecNum) const
sl@0:     {
sl@0:     ASSERT(aCacheSecNum < iBitCache.Size());
sl@0:     return (aCacheSecNum << iFatIdxToSecCoeff);
sl@0:     }
sl@0: 
sl@0: /** @return state of the cache*/
sl@0: CFatBitCache::TState CFatBitCache::State() const 
sl@0:     {
sl@0:     return iState;
sl@0:     }
sl@0: 
sl@0: /** 
sl@0:     @return ETrue if the cache can be used, i.e. is fully populated
sl@0: */
sl@0: TBool CFatBitCache::UsableState() const
sl@0:     {
sl@0:     return State() == EPopulated;
sl@0:     }
sl@0: 
sl@0: 
sl@0: /**
sl@0:     @return ETrue if the FAT cache sector number "aFatSectorNum" is marked as having at least one free FAT entry.
sl@0:     N.B. The cache must be in consistent state, i.e. fully populated.
sl@0: */
sl@0: TBool CFatBitCache::FatSectorHasFreeEntry(TUint32 aFatSectorNum) const
sl@0:     {
sl@0:     ASSERT(UsableState());
sl@0:     return iBitCache[aFatSectorNum];
sl@0:     }
sl@0: 
sl@0: /**
sl@0:     Mark FAT cache sector number "aFatSectorNum" is as having/not having free FAT entry.
sl@0:     N.B. The cache must be in consistent state, i.e. fully populated.
sl@0: 
sl@0:     @param  aFatSectorNum FAT32 cache sector number [index in a bit vector] 
sl@0:     @param  aHasFreeEntry ETrue  if we want to mark this sector as having free FAT entries; 
sl@0:                           EFalse if we want to mark this sector as NOT having free FAT entries; 
sl@0: */
sl@0: void CFatBitCache::SetFreeEntryInFatSector(TUint32 aFatSectorNum, TBool aHasFreeEntry)
sl@0:     {
sl@0:     ASSERT(UsableState());
sl@0:     iBitCache.SetBitVal(aFatSectorNum, aHasFreeEntry);
sl@0:     }
sl@0: 
sl@0: 
sl@0: #endif //SL_FAT_CACHE_32_INL
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: