Main Page   Modules   Alphabetical List   Data Structures   Data Fields  

Windows
[RtFSyst]


Modules

Data Types

Functions

RtFileSystemRtWinFSystemInit (RwInt32 maxNbOpenFiles, RwChar *deviceName, RwChar *fileSystemName)

Detailed Description

The Windows file system allows for synchronous and asynchronous file operations to be performed. This file system uses a driver internal read and write bufferring system.

Function Documentation

RtFileSystem* RtWinFSystemInit RwInt32    maxNbOpenFiles,
RwChar   deviceName,
RwChar   fileSystemName
 

RtWinFSystemInit is called to initialise the Windows file system.

This function must be called after opening the file system manager. It is responsible for creating the Windows file system, and initializing its file function table. This initialization function requires a valid device name to be passed. This allows greater flexibility, and is particularly useful during development, i.e. its does not tie the application to reading or writing from/to a specific device. Note that the device name of a specific file system can be changed using the RtFileSystemSetDeviceName function.

The file system toolkit allows you to call this function several times. For example you can register several windows file system (each with a different name) that corresponds to each available drive or partition on your local machine. This is a way to ensure that every possible files will be opened using a particular file system. However this solution may not be the most optimal as it will require more memory. Also note that should you wish to create and register a single Windows file system, you will need to change the device name (using the RtFileSystemSetDeviceName function) to the one on which you want to perform some I/O operations.

Parameters:
maxNbOpenFiles  Maximum number of concurrently opened file this file system can handle.
deviceName  Name of the device this file system represents. The device name specified must be a valid partition name.
fileSystemName  This is the unique name for this file system. Note that the size of this name must not exceed RTFS_MAX_NAME_LENGTH.
Returns:
A pointer to the newly created Windows file system, or NULL if initialization failed.


Criterion Software © 1993-2004 Criterion Software Limited. All rights reserved. Built Thu Feb 12 13:47:10 2004. Send Feedback