CTRDG_WriteAndVerifyAgbSramAsync

C Specification

#include <nitro/ctrdg.h>
void CTRDG_WriteAndVerifyAgbSramAsync(u32 dst, const void* src, u32 size, CTRDG_TASK_FUNC callback);
  

Arguments

dst Writes the destination SRAM address (address on the AGB memory map).
src Writes the source work area address.
size The size of data written/verified in bytes
callback The callback function called when WriteAndVerify processing ends

Return Values

None.

Description

Internally, after data is asynchronously written by CTRDG_WriteAgbSram, verification is asynchronously performed by CTRDG_VerifyAgbSram. If there is an error, the function retries up to the number of times specified by CTRDG_AGB_SRAM_RETRY_MAX (defined in AgbSram.h). You can find out whether the WriteAndVerify process succeeded by accessing the result member of the CTRDGTaskInfo structure used as an argument to the callback function that returns after this routine is called. It is 0 if the WriteAndVerify process succeeded, non-zero if the process failed, and the error address on the device side if there was a verification error.

The access cycle setting is created in the function and does not need to be set beforehand.

Note: The cartridge bus is locked for a set period by this function.
Note that the AGB backup device cannot be accessed normally with version IS-NITRO-DEBUGGER 1.66 or earlier.

See Also

CTRDG_WriteAgbSram, CTRDG_VerifyAgbSram, CTRDG_WriteAndVerifyAgbSram

Revision History

05/25/2006 Added a description that the AGB backup device cannot be accessed normally with version IS-NITRO-DEBUGGER 1.66 or earlier.
04/07/2006 Initial version.


CONFIDENTIAL