#include <dwc.h>
int DWC_StartUtility( void* work, int language, int param );
int DWC_StartUtilityEx( int language, int param );
Starts the process of configuring the Nintendo Wi-Fi Connection settings.
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.
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
}
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 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 |
| Japanese | Japan | No | Yes | --- |
| Japanese | Outside of Japan | --- | --- | Error |
| Non-Japanese | North America / Europe / Common | None | None | --- |
| Non-Japanese | Japan | --- | --- | Error |
0 |
Function completes successfully. |
Other |
Argument error. |
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_StartUtilityEx function
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 regions
2005/07/22 Initial version
CONFIDENTIAL