userlibandfileserver/fileserver/sfsrv/cl_fraw.cpp
changeset 0 a41df078684a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/userlibandfileserver/fileserver/sfsrv/cl_fraw.cpp	Mon Oct 19 15:55:17 2009 +0100
@@ -0,0 +1,197 @@
+// Copyright (c) 1996-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// f32\sfsrv\cl_fraw.cpp
+// 
+//
+
+#include "cl_std.h"
+
+
+
+
+/**
+Opens a direct access channel to the disk.
+
+Other resources are disabled from accessing the disk until Close() is called.
+
+Note that if any resources are currently open on the disk, an error
+is returned.
+
+@param aFs    The file server session.
+@param aDrive The drive containing the disk to be accessed. Specify a drive
+              in the range EDriveA to EDriveZ for drives A to Z.
+
+@return KErrNone, if successful;
+        KErrInUse is returned if any resources are currently open on the disk;
+        otherwise one of the other system-wide error codes.
+
+@capability TCB
+
+*/
+EXPORT_C TInt RRawDisk::Open(RFs& aFs,TInt aDrive)
+	{
+	if (!RFs::IsValidDrive(aDrive))
+		return(KErrArgument);
+	iDrive=aDrive;
+	return(CreateSubSession(aFs,EFsRawDiskOpen,TIpcArgs(aDrive)));
+	}
+
+
+
+
+/**
+Closes the direct access channel to the disk, and allows other resources
+to access the disk.
+*/
+EXPORT_C void RRawDisk::Close()
+	{
+	CloseSubSession(EFsRawSubClose);
+	}
+
+
+
+
+/**
+Reads directly from the disk.
+
+The function reads a number of bytes into the specified descriptor from
+the disk, beginning at the specified position.
+
+@param aPos The position on the disk at which to begin reading.
+@param aDes The descriptor into which data is to be read. 
+            On return aDes contains the data read.
+
+@panic User In debug builds, the media driver panics if aPos is larger than 
+            the size of the physical media or if the end address, given by 
+            aPos + the maximum length of the descriptor, is greater than 
+            the size of the physical media.
+
+@return KErrNone, if successful, otherwise one of the other system-wide error
+        codes.
+
+@capability TCB
+
+*/
+EXPORT_C TInt RRawDisk::Read(TInt64 aPos,TDes8& aDes)
+	{
+	TInt maxLength = aDes.MaxLength();
+	if (maxLength==0)
+		return(KErrNone);
+	TPtrC8 tBuf((TUint8*)&aPos,sizeof(TInt64));
+	return(SendReceive(EFsRawDiskRead,TIpcArgs(&aDes,maxLength,&tBuf)));
+	}
+
+
+
+
+/**
+Writes directly to the disk.
+
+The function writes the contents of the specified descriptor to the 
+disk at position aPos.
+
+@param aPos The position at which to begin writing.
+@param aDes The descriptor containing the data to be written to the disk.
+
+@panic User In debug builds, the media driver panics if aPos is larger than 
+            the size of the physical media or if the end address, given by 
+            aPos + the maximum length of the descriptor, is greater than 
+            the size of the physical media.
+
+@return KErrNone, if successful, otherwise one of the other system-wide error
+        codes.
+
+@capability TCB
+
+*/
+EXPORT_C TInt RRawDisk::Write(TInt64 aPos,TDesC8& aDes)
+	{
+	TInt length = aDes.Length();
+	if (length==0)
+		return(KErrNone);
+	TPtrC8 tBuf((TUint8*)&aPos,sizeof(TInt64));
+	return(SendReceive(EFsRawDiskWrite,TIpcArgs(&aDes,length,&tBuf)));
+	}
+
+
+
+
+//
+// Old read / write methods left in to be BC
+//
+class _RRawDisk : public RRawDisk
+	{
+public:
+	IMPORT_C TInt Read(TInt aPos,TDes8& aDes);
+	IMPORT_C TInt Write(TInt aPos,TDesC8& aDes);
+	};
+
+
+
+
+/**
+Reads directly from the disk.
+
+The function reads a number of bytes into the specified descriptor from
+the disk beginning at the specified position.
+
+@param aPos The position on the disk at which to begin reading.
+@param aDes The descriptor into which data is to be read. On return, contains the
+            data read. The number of bytes read is the smaller of:
+            a) the total number of bytes on the disk minus aPos;
+            b) the maximum length of the descriptor.
+
+@return KErrNone, if successful, otherwise one of the other system-wide error
+        codes.
+
+@capability TCB
+@deprecated
+*/
+EXPORT_C TInt _RRawDisk::Read(TInt aPos,TDes8& aDes)
+	{
+	TInt maxLength = aDes.MaxLength();
+	if (maxLength==0)
+		return(KErrNone);
+	TInt64 pos = MAKE_TINT64(0,aPos);
+	TPtrC8 tBuf((TUint8*)&pos,sizeof(TInt64));
+	return(SendReceive(EFsRawDiskRead,TIpcArgs(&aDes,maxLength,&tBuf)));
+	}
+
+
+
+
+/**
+Writes directly to the disk.
+
+The function writes the contents of the specified descriptor to the 
+disk at position aPos.
+
+@param aPos The position at which to begin writing.
+@param aDes The descriptor containing the data to be written to the disk.
+
+@return KErrNone, if successful, otherwise one of the other system-wide error
+        codes.
+
+@capability TCB
+@deprecated
+*/
+EXPORT_C TInt _RRawDisk::Write(TInt aPos,TDesC8& aDes)
+	{
+	TInt length = aDes.Length();
+	if (length==0)
+		return(KErrNone);
+	TInt64 pos = MAKE_TINT64(0,aPos);
+	TPtrC8 tBuf((TUint8*)&pos,sizeof(TInt64));
+	return(SendReceive(EFsRawDiskWrite,TIpcArgs(&aDes,length,&tBuf)));
+	}