FAT

FatVolOpen()

PROTOTYPE

#include <fsdriver.h>

FAT *FatVolOpen(const char *name);

DESCRIPTION

FatVolOpen() reserves the unmounted FAT volume specified by name, acquiring exclusive access to its read sector/write sector driver interface, such as is needed by a USB Mass Storage Device interface.

If successful, FatVolOpen() returns a handle that can be used by the other FatVolXxx() routines. Otherwise, it sets errno and returns NULL.

ERROR CODES

EEXIST	The volume specified by name is currently mounted.
EFAULT	name equals NULL.
ENOENT	No attached volume matches the specified name.

EXAMPLE

      FAT *fat;

      /*---------------------------------------------------------------*/
      /* Reserve volume and get handle to its sector interface.        */
      /*---------------------------------------------------------------*/
      fat = FatVolOpen(vol_name);
      if (fat == NULL)
        return -1;