#include <dwc.h>
int DWC_StartUtility( void* work, int language, int param );
Starts the Nintendo Wi-Fi Connection setup. When calling this function, be aware of the following:
Furthermore, after the function ends normally, be aware of the following. (nothing is processed if it ends as a result of an argument error)
The Nintendo Wi-Fi Connection settings reference files on the DS card by using the NITRO-SDK file system. Specify $(NITRODWC_ROOT)/file/dwc/utility.bin
in the dwc/
directory as a root directory. If the application does not use the file system, add the following text to the RomSpec section in the ROM spec file, and call FS_Init()
from the application to enable file system use.
RomSpec
{
...
# From here
HostRoot ./file/dwc # file directory name on PC
Root /dwc
File utility.bin
# To here
}
The function DWC_StartUtilityEx
is also provided for static linking of the necessary buffers.
work |
Pointer to a 32-byte aligned DWC_UTILITY_WORK_SIZE byte buffer. Can be deleted after the function completes. |
language |
Language used by the application DWC_LANGUAGE_JAPANESE // Japanese DWC_LANGUAGE_ENGLISH // English DWC_LANGUAGE_FRENCH // French DWC_LANGUAGE_GERMAN // German DWC_LANGUAGE_ITALIAN // Italian DWC_LANGUAGE_SPANISH // Spanish |
param |
Specifies the destination and configuration utility start position. The support phone number displayed in the configuration utility and whether easy wireless start is used will depend on the destination. DWC_UTILITY_TOP_MENU_FOR_USA // For North America Start from top menu DWC_UTILITY_SETTING_FOR_USA //For North America Start from connection target selection DWC_UTILITY_TOP_MENU_FOR_EUR //For Europe Start from top menu DWC_UTILITY_SETTING_FOR_EUR // For Europe Start from connection target selection DWC_UTILITY_TOP_MENU_FOR_JPN //For Japan Start from top menu DWC_UTILITY_SETTING_FOR_JPN //For Japan Start from connection target selection DWC_UTILITY_TOP_MENU_COMMON //For Common Start from top menu DWC_UTILITY_SETTING_COMMON //For Common Start from connection target selection |
Language and destination combination and support phone number, use of easy wireless start
Language |
Destination |
Support phone number |
Easy Wireless Start |
Comments |
Japan | Japan | No | Yes | --- |
Japan | Outside of Japan | --- | --- | Error |
English | North America | Yes | No | --- |
English | Europe/Common | No | No | --- |
English | Japan | --- | --- | Error |
Neither Japanese nor English | North America | No | No | --- |
Neither Japanese nor English | Europe/Common | No | No | --- |
Neither Japanese nor English | Japan | --- | --- | Error |
0 |
Function completed normally. |
Non-zero |
Argument error. |
DWC_StartUtilityEx , DWC_SetAuthServer
02/22/2006 Added description specific to NITRO-Composer
12/16/2005 Revisions
09/30/2005 Added notes to Description, corrected errors in Arguments, and added a table on language and market region combinations
07/22/2005 Initial version