FSGetMountSourceNext

Syntax

#include <cafe/fs.h>

FSStatus FSGetMountSourceNext(
                FSClient                        *client,
                FSCmdBlock                      *block,
                FSMountSource                   *source,
                FSRetFlag                       errHandling
                );
FSStatus FSGetMountSourceNextAsync(
                FSClient                        *client,
                FSCmdBlock                      *block,
                FSMountSource                   *source,
                FSRetFlag                       errHandling,
                const   FSAsyncParams           *asyncParams
                );

Parameters

client Pointer to a client buffer.
block Command block.
source Pointer to an available mountable source. For more information, see FSMountSource.
errHandling Auto error handling flag. Only indicated errors are returned.
asyncParams (Async API only) Notification parameters for an asynchronous call.

Return Values

Sync API : Return values / Async API: Callback return values

FS_STATUS_OK Successfully retrieved the next available mount source.
FS_STATUS_END Current mount source position is at the end.
FS_STATUS_CANCELED Command was canceled.

Async API: Immediate return values

FS_STATUS_OK Successfully issued request.
FS_STATUS_FATAL_ERROR The argument is invalid.

Description

Find and get one of the available mountable sources of the specified type. This function is for manually mounted external devices (SD with FAT) and the Host File IO (HFIO) volume.

This function is used to get subsequent sources after the first one, when multiple sources are possibly available for the specified type. Use FSGetMountSource to get the first source on the list. The context for this procedure is stored per FSClient struct.

Both a sync and async style API are provided. To use the async API, set the user callback and parameters in asyncParams. For more information, see FSAsyncParams.

Do Not Call From

FSGetMountSourceNext

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.

FSGetMountSourceNextAsync

None.

See Also

Mount
FSMount
FSUnmount
FSGetMountSource

Revision History

2014/09/16 Added "Thread that displays graphics" and "Thread that handles system messages" to "Do not call from".
2013/05/08 Automated cleanup pass.
2013/01/10 Added "Callback" to "Do not call from".
2012/11/20 Replaced "FAT32" to "FAT".
2012/07/19 Readability cleanup.
2010/12/12 Initial version.
2010/03/30 Fixed type name FSNotificationParams -> FSAsyncParams.


CONFIDENTIAL