DWC_Init

C Specification

#include <dwc.h>

int DWC_Init( void* work );

Description

This function initializes the DWC library. Creates and checks the user ID to be saved on the DS system. Call this function once before calling other APIs included in the DWC library.

Display an appropriate message that corresponds to the return value. For creating this error messages, refer to the Nintendo Wi-Fi Connection Programming Guideline.

Once this function ends, you can release the buffer specified by work. こThis buffer is accessed from the ARM7, so be sure to specify memory that can be accessed from the ARM7, such as main memory.

One of the following functions must be called prior to calling this function: OS_Init, OS_InitTick, OS_InitAlarm, or RTC_Init.

This function requires a PXI interrupt for synchronization. Do not call this function when PXI interrupts are disabled.

Arguments

work Pointer to the initialization buffer.
Specify a buffer that is 32-byte aligned and has the size of DWC_INIT_WORK_SIZE.

Return Values

DWC_INIT_RESULT_NOERROR Initialization succeeded.
DWC_INIT_RESULT_CREATE_USERID Generated temporary user ID on the DS system.
DWC_INIT_RESULT_DESTROY_USERID Generated a temporary user ID because the user ID on the DS system may have been deleted.
DWC_INIT_RESULT_DESTROY_OTHER_SETTING The DS system connection target settings may be corrupted.

See Also

DWC_CreateUserData

Revision History

08/02/2006 Added cautions on buffer for initialization and the PXI interrupt.
03/07/2006 Added description of functions which need to be called in advance.
02/24/2006 Changed the reference document name.
12/16/2005 Revisions.
10/20/2005 Revisions.
07/22/2005 Initial version.


CONFIDENTIAL