#include <dwc.h>
int DWC_StartUtility( void* work, int language, int param );
int DWC_StartUtilityEx( int language, int param );
Starts the Nintendo Wi-Fi Connection setup utility.
The DWC_StartUtility function is available to provide outside buffers as needed, and the DWC_StartUtilityEx function is available to make use of the items stored in static.
The Nintendo Wi-Fi Connection setup must be implemented by all titles that support Nintendo Wi-Fi Connection so players are presented with a common interface for the following features:
When calling this function, be aware of the following:
param argument to specify where in the Nintendo Wi-Fi Connection setup to start from, the application must have a scene where players can open the utility from the Top Menu.Select Connection Target.Select Connection Target is not required to be implemented. It is provided as a means, for example, for players to be guided directly to the connection target settings when an error occurs while connecting to the Internet.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
}
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 DWC_LANGUAGE_HANGUL // Korean |
param |
Specifies the market and where in the Nintendo Wi-Fi Connection setup to start. Depending on the market, the Easy Wireless Start feature may or may not be enabled. 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 |
Easy Wireless Start availability depends on combination of language and market:
Language |
Destination |
Easy Wireless Start |
Comments |
| Japanese | Japan | Yes | --- |
| Japanese | Outside of Japan | --- | Error |
| Non-Japanese | North America / Europe / Common | None | --- |
| Non-Japanese | Japan | --- | Error |
0 |
Function completes successfully. |
Other |
Argument error. |
2008/01/18 Added explanation about the features of the Nintendo Wi-Fi Connection setup utility.
2008/01/18 Added a caution about the starting location of Nintendo Wi-Fi Connection setup.
2008/01/18 Deleted the text about support phone numbers.
2007/03/28 Changed the phone support number for the English language in combination with the North America region to "None".
2007/03/22 Added a warning about using customized libraries.
2007/03/22 Integrated with the DWC_StartUtilityExfunction.
2006/12/27 Added support for the Korean language and emphasized precautions.
2006/11/07 Added a caution about overlays.
2006/02/22 Added a note about NITRO composer.
2005/12/16 Made revisions.
2005/09/30 To the description added points of attention, corrected a mistake with an argument, and added a table related to the combinations of languages and markets.
2005/07/22 Initial version.
CONFIDENTIAL