#include <dwc.h>
void DWC_CreateUserData( DWCUserData* userdata, u32 gamecode );
Generates user data for each game player. Save this user data on the DS card in the backup memory. Data will be generated with the dirty flag enabled; therefore, clear the dirty flag using the DWC_ClearDirtyFlag function before saving.
Use the DWC_InitFriendsMatch function to set communication groups for each game title level to avoid mixed communications with other games when using a Wi-Fi connection. The gamecode value sets the range of friend relationships (namespace) in these communication groups.
Specify the initial codes normally allocated to each game title in the gamecode, and be sure to provide any of the initial codes for when attempting to establish a friend relationship between devices with different regional settings.
Specifying different gamecodes has the following effect on the exchange of friend information:
| Exchange by Friend Registration Keys | When the DWC_CheckFriendKey function is used to check friend registration keys, its return value indicates that data is invalid. |
| Exchange through DS Wireless Communications | There is no method for checking the validity of friend information, but no friend relationship is established, even though friend information is added to the friend roster. For details see DWC_CreateExchangeToken function reference. |
Even among software titles that have different gamecodes specified, peer matchmaking without friend specification is possible if the DWC_InitFriendsMatch function is used to set identical networking units in each game title.
Note: Starting from NITRO-DWC 3.0, a different method is employed to generate the value used to check the validity of friend registration keys. Because of this change, the friend registration keys created with older versions of NITRO-DWC are no longer compatible.
userdata |
Pointer to the DWCUserData structure where the generated user data is stored. |
gamecode |
Normally, the game code assigned to each game. (Uppercase alphanumeric one-byte characters) Example: If the game code is NTRJ, then DWC_CreateUserData(&userdata, 'NTRJ'); |
None.
DWC_InitFriendsMatch,
DWC_CheckDirtyFlag,
DWC_ClearDirtyFlag,
DWC_CheckFriendKey,
DWC_CreateFriendKey,
DWC_CreateExchangeToken
2008/01/16 Added warning about the compatibility of friend registration keys.
2007/12/12 Added an example of the specification for gamecode.
2007/01/25 Added text to the explanation about when a different gamecode has been specified.
2006/08/10 Added a caution regarding gamecode.
2005/12/16 Revisions.
2005/10/26 Revisions.
2005/07/22 Initial version.
CONFIDENTIAL