NANDSeekAsync

C Specification

#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 offset is specified in bytes.
whence	Specifies the base position for the seek. NAND_SEEK_SET Start of file. NAND_SEEK_CUR Current position in the file. NAND_SEEK_END End of file.
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. If the seek is successful, the position in the file after the seek is passed to the callback function.

NAND_RESULT_ACCESS
NAND_RESULT_ALLOC_FAILED
NAND_RESULT_BUSY
NAND_RESULT_INVALID
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR


Description

Performs a file seek asynchronously. The starting position of the next read or write is the offset plus whence. If the offset value is positive, the seek position moves from the base point towards the end of the file. If the value is negative, the seek position moves from the base point towards the start of the file. If the queue receiving the request is full in the library, this function call is refused and NAND_RESULT_BUSY is returned.

See Also

NANDSeek, NANDRead, NANDReadAsync, NANDWrite, NANDWriteAsync

Revision History

06/16/2006 Initial version.