NANDReadAsync

Syntax

#include <revolution/nand.h>

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

s32 NANDReadAsync( NANDFileInfo *info, void *buf, u32 length, NANDCallback cb, NANDCommandBlock *block );

Arguments

info Pointer to a NANDFileInfo structure.

buf Pointer to the write destination for the data that was read. The write buffer must be 32-byte aligned.

length Number of bytes to read. This value must be a multiple of 32.

cb Callback function to call when this function completes processing.

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

info	Pointer to a `NANDFileInfo` structure.
buf	Pointer to the write destination for the data that was read. The write buffer must be 32-byte aligned.
length	Number of bytes to read. This value must be a multiple of 32.
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 may be returned by NANDReadAsync 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 read is successful, the number of bytes for the read data is passed to the callback function.

NAND_RESULT_ACCESS NAND_RESULT_AUTHENTICATION NAND_RESULT_CORRUPT NAND_RESULT_ECC_CRIT NAND_RESULT_INVALID NAND_RESULT_UNKNOWN NAND_RESULT_FATAL_ERROR

Description

Asynchronously reads data from a file in Wii console NAND memory. NAND_RESULT_BUSY is returned and this function call is denied when the queue for accepting requests inside the library is full.

If, while the NANDReadAsync function is processing, certain functions or combinations of functions are called from a different thread, the processing of these other functions may be delayed or even fail. For more information about the occurrence conditions, symptoms, and workarounds, see Notes Regarding Read/Writes to Wii Console NAND Memory.

Revision History

2009/12/02 Added the Notes Regarding Read/Writes to Wii Console NAND Memory information.
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/10/xx Unified terminology.
2006/08/15 Added the AUTHENTICATION result code.
2006/06/16 Initial version.