NANDSeekAsync

Syntax

#include <revolution/nand.h>

#define NAND_SEEK_SET          0
#define NAND_SEEK_CUR          1
#define NAND_SEEK_END          2

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

s32 NANDSeekAsync( NANDFileInfo *info, s32 offset, s32 whence, NANDCallback cb, NANDCommandBlock *block );

Arguments

info	Pointer to a NANDFileInfo structure.
offset	Specifies the offset value The size is given in bytes.
whence	Specifies the seek base position. NAND_SEEK_SET Start of file. NAND_SEEK_CUR Current position of file. NAND_SEEK_END End of file.
cb	Callback function to call when this function completes processing.
block	Command block structure to be passed to the callback function.

Return Values

The result codes that NANDSeekAsync can return are listed below. 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_FATAL_ERROR


The result codes that may be passed to the callback function are listed below. When the seek is successful, the seek target position is passed to the callback function.

NAND_RESULT_ACCESS
NAND_RESULT_INVALID
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR


Description

Performs a file seek asynchronously. The start position of the next read or write is that indicated by the whence argument plus the offset value. If the offset value is positive, the seek position moves from the base point to the file's end. If the value is negative, the seek position moves from the base point toward the file's start. NAND_RESULT_BUSY is returned and this function call is denied when the queue for accepting requests inside the library is full.

See Also

NANDSeek, NANDRead, NANDReadAsync, NANDWrite, NANDWriteAsync

Revision History

2008/08/01 Revised the result codes that are passed to the callback function.
2008/05/13 Described the result codes passed to the callback function.
2006/06/16 Initial version.

CONFIDENTIAL