NANDWriteAsync

Syntax

#include <revolution/nand.h>

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

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

Arguments

info Pointer to a NANDFileInfo structure.
buf Pointer to the start of the data that will be written to Wii console NAND memory. The buffer storing the data must be 32-byte aligned.
length Number of bytes of data to write to Wii console NAND memory.
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 NANDWriteAsync 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 write is successful, the number of bytes for the written 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_MAXBLOCKS
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR

Description

Asynchronously writes data to a file. NAND_RESULT_BUSY is returned and this function call is denied when the queue for accepting requests inside the library is full.

See Also

NANDRead, NANDReadAsync, NANDWrite, NANDSeek, NANDSeekAsync

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/10/xx Unified terminology.
2006/09/19 Added the ECC_CRIT result code.
2006/09/07 Eliminated the restriction that the write size had to be a multiple of 32 bytes.
2006/08/15 Added the AUTHENTICATION result code.
2006/06/16 Initial version.


CONFIDENTIAL