DWC_StartUtility*

C Specification

#include <dwc.h>

int DWC_StartUtility( void* work, int language, int param );

int DWC_StartUtilityEx( int language, int param );

Description

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
}

Arguments

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

Return Values

0 Function completes successfully.
Other Argument error.

See Also

DWC_SetAuthServer

Revision History

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