Page Comparison

...

Returned Value

None.

Notes/Warnings

1. The return error code from the function SHOULD always be checked by the calling application to determine whether the device was successfully opened. Repeated calls to FSDev_Open() resulting in errors that do not indicate failure to open (such as FS_ERR_DEV_LOW_FMT_INVALID) without matching FSDev_Close() calls may exhaust the supply of device structures.
   1. If FS_ERR_NONE is returned, then the device has been added to the file system and is immediately accessible.
   2. If FS_DEV_INVALID_LOW_FMT is returned, then the device has been added to the file system, but needs to be low-level formatted, though it is present.
   3. If FS_ERR_DEV_NOT_PRESENT, FS_ERR_DEV_IO or FS_ERR_DEV_TIMEOUT is returned, then the device has been added to the file system, though it is probably not present. The device will need to be either closed and re-added, or refreshed.
   4. If any of the follwing is returned:
      • FS_ERR_DEV_INVALID_NAME
      • FS_ERR_DEV_INVALID_SEC_SIZE
      • FS_ERR_DEV_INVALID_SIZE
      • FS_ERR_DEV_INVALID_UNIT_NBR
      • FS_ERR_DEV_NONE_AVAIL

      ...then the device has not been added to the file system.

   5. If FS_ERR_DEV_UNKNOWN is returned, then the device driver is in an indeterminate state. The system MAY need to be restarted and the device driver should be examined for errors. The device has not been added to the file system.