Page Comparison

void  FSVol_Open (CPU_CHAR          *name_vol,

...

                  CPU_CHAR          *name_dev,

...

                  FS_PARTITION_NBR   partition_nbr,

...

                  FS_ERR            *p_err);

...

Arguments

name_vol

Volume name. See Section 2.04 for Device and volume names for information about device names.

...

Pointer to variable that will receive the return error code from this function. See Note #2 .

FS_ERR_NONE

Volume opened.

...

No volumes available.

Or device access error (see section B-4 “Device Error Codes”see Device Error Codes).

Returned Value

None.

Notes/Warnings

1. If FS_ERR_PARTITION_NOT_FOUND is returned, then no valid partition (or valid file system) was found on the device. It is still placed on the list of used volumes; however, it cannot be addressed as a mounted volume (e.g., files cannot be accessed). Thereafter, unless a new device is inserted, the only valid commands are
2. FSVol_Fmt(), which creates a file system on the device;
3. FSVol_Close(), which frees the volume structure;
4. FSVol_Query(), which returns information about the device.
5. If FS_ERR_DEV, FS_ERR_DEV_NOT_PRESENT, FS_ERR_DEV_IO or FS_ERR_DEV_TIMEOUT is returned, then the volume has been added to the file system, though the underlying device is probably not present. The volume will need to be either closed and re-added, or refreshed.