NANDOpenAsync

C Specification

#include <revolution/nand.h>

#define NAND_ACCESS_READ       0x01
#define NAND_ACCESS_WRITE      0x02
#define NAND_ACCESS_RW         (NAND_ACCESS_READ | NAND_ACCESS_WRITE)

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

s32 NANDOpenAsync( const char *path, NANDFileInfo *info, u8 accType, NANDCallback cb, NANDCommandBlock *block );

Arguments

path	Name of the file to open.
info	Pointer to a NANDFileInfo structure.
accType	Access type. Specifies either NAND_ACCESS_READ, NAND_ACCESS_WRITE or NAND_ACCESS_RW.
cb	Specifies the callback function to call when this function completes processing.
block	Specifies the command block structure to pass to the callback function.

Return Values

Returns NAND_RESULT_OK when the request begins normally.

NAND_RESULT_OK
NAND_RESULT_ACCESS
NAND_RESULT_ALLOC_FAILED
NAND_RESULT_BUSY
NAND_RESULT_INVALID
NAND_RESULT_MAXFD
NAND_RESULT_NOEXISTS
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR


Description

Asynchronously opens a file. Proper access rights are required to open a file. You cannot open files without proper permissions. If the queue receiving the request is full in the library, this function call is refused and NAND_RESULT_BUSY is returned.

See Also

NANDOpen, NANDClose, NANDCloseAsync

Revision History

06/16/2006 Initial version.