NANDWrite

Syntax

#include <revolution/nand.h>

s32 NANDWrite(NANDFileInfo *info, const void *buf, u32 length);

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.

Return Values

Returns the number of bytes for the written data when the write is successful. One of the following codes is returned on failure.

NAND_RESULT_ACCESS
NAND_RESULT_ALLOC_FAILED
NAND_RESULT_AUTHENTICATION
NAND_RESULT_BUSY
NAND_RESULT_CORRUPT
NAND_RESULT_ECC_CRIT
NAND_RESULT_INVALID
NAND_RESULT_MAXBLOCKS
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR

Description

Writes data to a file.

This function sometimes puts the current thread to sleep, so it cannot be called from callback functions. For precautions related to calling similar functions, see Interrupts and Callback Functions.

If, while the NANDWrite 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.

See Also

NANDRead
NANDReadAsync
NANDWriteAsync
NANDSeek
NANDSeekAsync
Interrupts and Callback Functions
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.
2007/09/25 Added information about the sleep status of threads.
2006/11/30 Added the NAND_RESULT_ALLOC_FAILED and NAND_RESULT_BUSY codes.
2006/10/xx Unified terminology.
2006/09/19 Added the ECC_CRIT result code.
2006/09/07 Eliminated the restriction that the data-write size had to be a multiple of 32 bytes.
2006/08/15 Added the AUTHENTICATION result code.
2006/06/16 Initial version.


CONFIDENTIAL