NANDFreeBlocksAsync

C Specification


#include <revolution/nand.h>

typedef void (*NANDCallback)( s32 result, NANDCommandBlock *block );

s32 NANDFreeBlocksAsync( u32 *bytes, u32 *inodes, NANDCallback cb, NANDCommandBlock *block );

Arguments

bytes A pointer to a u32-type variable that stores (in bytes) the file system's available space.

inodes A pointer to a u32-type variable that stores the number of free inodes in the file system.

cb Callback function to call when this function completes processing.

block Command block structure to be passed to the callback function.

Return Values

Returns NAND_RESULT_OK when the request begins normally.

NAND_RESULT_OK NAND_RESULT_ALLOC_FAILED NAND_RESULT_BUSY NAND_RESULT_INVALID NAND_RESULT_UNKNOWN NAND_RESULT_FATAL_ERROR

Description

Obtains asynchronously the available space (in bytes) and the number of free i-nodes in the file system.
However, you cannot use this function to determine whether new files or directories can be created (to protect the free space reserved by the system). To determine whether new files and directories can be created, use NANDCheck[Async] or NANDGetAvailableArea[Async]. NAND_RESULT_BUSY is returned and this function call is denied when the queue for accepting requests inside the library is full.

Revision History

2006/10/25 Expanded statement to include NANDGetAvailableArea[Async]. Added links to See Also.
2006/08/30 Added caution regarding the creation of new files and directories.
2006/06/16 Initial version.

CONFIDENTIAL

`bytes`	A pointer to a u32-type variable that stores (in bytes) the file system's available space.
`inodes`	A pointer to a u32-type variable that stores the number of free inodes in the file system.
`cb`	Callback function to call when this function completes processing.
`block`	Command block structure to be passed to the callback function.