DWC_Debug_DWCInitError

Syntax

#include <dwc.h> 
void DWC_Debug_DWCInitError(void *work,
                            int dwc_init_error);

Arguments

work Pointer to the buffer for temporary processing. Specify a 32-byte aligned buffer of size DWC_INIT_WORK_SIZE.
dwc_init_error Error classification of the error you want to generate in the DWC_InitFor* functions. Specify one of the following. (You cannot specify DWC_INIT_RESULT_MEMORY_FULL.)
  • DWC_INIT_RESULT_CREATE_USERID
  • DWC_INIT_RESULT_DESTROY_USERID
  • DWC_INIT_RESULT_DESTROY_OTHER_SETTING

Return Values

None.

Description

Destroys the Wi-Fi setup information in the Nintendo DS system's backup memory to get a return value other than DWC_INIT_RESULT_NOERROR from the DWC_InitForDevelopment or DWC_InitForProduction function. After this function is called with an error classification that is specified in dwc_init_error, calling the DWC_InitForDevelopment or DWC_InitForProduction function returns the specified error type.
However, for the DWC_INIT_RESULT_DESTROY_OTHER_SETTING error type to be returned, Connection Target 1 must be configured with the Wi-Fi Connection setup utility ahead of time.

The buffer specified in work may be deallocated after this function exits.
Because this buffer is accessed from ARM7, specify a region in main memory or another location that can be accessed from ARM7.

This function is for debugging, but it also works with the libraries of the final version of ROM (FINALROM).

This function requires a PXI interrupt for synchronization; do not call it when PXI interrupts are prohibited.

Revision History

5.3
Added support for separation of the DWC_Init function into one for a development server and one for a production server.

For the change log prior to 5.1 PR2, click here.   


CONFIDENTIAL