DWC_StartUtility*

Syntax

#include <dwc.h>

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

int DWC_StartUtilityEx( int language, int param );

Description

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:

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 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

Return Values

0 Function completes successfully.
Other Argument error.

See Also

DWC_SetAuthServer

Revision History

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