#include <cafe/fs.h> FSStatus FSMount( FSClient *client, FSCmdBlock *block, FSMountSource *source, char *target, u32 bytes, FSRetFlag errHandling ); FSStatus FSMountAsync( FSClient *client, FSCmdBlock *block, FSMountSource *source, char *target, u32 bytes, FSRetFlag errHandling, const FSAsyncParams *asyncParams );
|client||Pointer to the client buffer.|
|source|| Pointer of mount source. For more information, see
|target||Buffer for target mount point path.|
|bytes||Length of the
|errHandling||Auto error handling flag. Only indicated errors are returned.|
|asyncParams||(Async API only) Notification parameters for an asynchronous call.|
||The command was canceled.|
||Target not found.|
||Specified device file is already mounted, or specified target path is in use with another volume.|
||Target has been formatted to unsupported file system.|
||The caller does not have correct access permission.|
||Media is in some inaccessible condition.|
||Successfully issued request.|
||The argument was invalid.|
Mount the volume designated by the device file path, source. The mount point path will be mapped to target.
Both a sync and async style API are provided. To use the async API, set user the callback and parameters in asyncParams.
For more information, see
FS_STATUS_FATAL_ERRORand will not be able to return from the API.
|Thread that displays graphics||Do not call this function from a thread that displays graphics. This function may block indefinitely in error cases and the application must be able to display appropriate messages.|
|Thread that handles system messages||Do not call this function from a thread that handles system messages. This function may block indefinitely in error cases and the application must be able to handle system events such as shutdown.|
|Callbacks||Do not call this function from any callback function.|
|Interrupt handler||Do not call this function from any interrupt handler.|
|Exception handler||Do not call this function from any exception handler.|
2014/09/16 Added "Thread that displays graphics" and "Thread that handles system messages" to "Do not call from".
2013/12/26 Added FS_STATUS_UNSUPPORTED_CMD and FS_STATUS_MEDIA_ERROR to return values.
2013/05/20 Added FS_STATUS_PERMISSION_ERROR to return values.
2013/05/09 Added a note about to access HostFile IO.
2013/05/08 Automated cleanup pass.
2013/01/10 Added "Callback" to "Do not call from".
2012/12/13 Added NOTE that this API is basically for development.
2012/08/01 Fixed "Arguments" source information.
2012/07/19 Readability cleanup.
2012/03/31 Fixed type name FSNotificationParams ->
FSAsyncParams. Removed FS_STATUS_MAX from return values. Changed target from input argument to output. Added size argument.
2011/12/06 Initial version.