DWC_GetDateTime function when the real-time clock exceeded 2099/12/31 23:59:59
NITRO-CHARACTER data file for each icon.
DWC_NdCleanupAsync function.
plus.
DWC_ProcessFriendsMatch function
(2007/05/18)
Changed the maximum size of the user-defined data that can be used with general ranking from 768 bytes to 764 bytes.
Added Korea (DWC_RNK_REGION_KR) to the region codes used with general ranking.
Following this change, Korea has also been added to the region specification of the general-purpose ranking management tool.
When a DNS error occurred in the DWCi_QR2Startup function of an internal function, the memory that was allocated within that function was not being freed. This problem has been fixed.
There was a problem with references to a NULL pointer when communications errors occurred at certain limited times during matchmaking. This problem has been fixed.
A maximum of 8 KB was allocated from the stack by HTTP communications (the GHTTP library). This has been corrected such that the memory is now allocated from the heap.
Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.
Made revisions to the following items. For details, see the revision history for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.
DWC_ConnectProfanityProcess functionDWC_LogoutFromStorageServer functionDWCStorageLoginCallback functionDWCSaveToServerCallback functionDWCLoadFromServerCallback functionDWCRnkRegion typeNone.
(2007/04/09)
For online checking of invalid character strings, added the following functions:
For details, see the function reference and the added dwc_prof_sample sample demo.
Removed the support telephone number that was displayed when "North America" was set for the region and "English" was set for the language under Nintendo Wi-Fi Connection settings.
With this change in specifications, there will no longer be any region-dependent difference in the displayed message.
DWC_GetDateTime function when the real-time clock exceeded 2099/12/31 23:59:59
In the past, when the DWC_GetDateTime function was used for date and time retrieval from the authentication server, execution would fail if the real-time clock exceeded 2099/12/31, 23:59:59. We have corrected this problem.
Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.
Made additions and revisions to the items listed below. For details, see the Revision History for each item.
Note: The revision histories may not reflect some of the minor changes, such as modifications in terminology.
DWC_ConnectToAnybodyAsync functionDWC_ConnectProfanityProcess functionDWC_GetLastError* functionDWC_StartUtility* functionsNone.
(2007/03/12)
To get the authenticated user ID stored in the DS, added the DWC_GetAuthenticatedUserId function.
Added the DWC_FriendKeyToString and DWC_StringToFriendKey functions for back-and-forth conversions between friendship registration keys and 12-digit decimal strings.
To the $NITRODWC_ROOT/data/Wi-Fi_icons/ directory, added the NITRO-CHARACTER data for the "Wi-Fi Connection support icon" and the "Wi-Fi signal strength icon." Use these data for the icons included in the titles that support the Wi-Fi Connection.
Revamped the socket closing process in the Download library as follows: revised the code such that the callback that notifies the end of an asynchronous process is issued without waiting for the socket closing process to end.
DWC_NdCleanupAsync function.
Corrected the following problem: the internal process inside the DWC_NdCleanupAsync function was sometimes blocked for several seconds.
Fixed the problem with the private functions being used in the sample demos. Also made other minor revisions.
Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.
Made additions and revisions to the following items. For details, see the Revision History for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.
DWC_FriendKeyToString functionDWC_StringToFriendKey functionDWC_GetAuthenticatedUserId functionDWC_StartUtilityEx functionNone.
(2007/02/02)
The version of CodeWarrior for the AOSS/Easy Wireless Start Library used in the Wi-Fi Connection configuration was changed to 2.0 SP1.
Therefore, all versions of CodeWarrior used in the build for the NITRO-DWC package were changed to 2.0 SP1.
DWC_ProcessFriendsMatch function
Corrected a bug that caused the DWC_GetLastError[Ex] function to unintentionally set to DWC_ERROR_FATAL when continuing the internal processing after an error occurred while the DWC_ProcessFriendsMatch was in progress.
Corrected a bug that caused friend relationships to be established, even between titles in which the DWC_CreateUserData function specified different initial codes.
Specifically, this bug was occurring when the titles had connected to a Wi-Fi connection at least once and the friend information exchanged in DS Wireless Networking was created or exchanged.
Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.
Revisions were made to the following items. For details, see the revision history for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.
DWC_ClearError functionDWC_CreateExchangeToken functionDWC_CreateFriendKey functionDWC_CreateUserDataDWC_GetFriendKey functionDWC_IsBuddyFriendData functionDWC_NdCancelAsync functionDWC_NdGetFileAsync functionDWC_NdGetFileListAsync functionDWC_NdGetFileListNumAsync functionDWC_NdInitAsync functionDWC_TestInetProcessNone.
(2007/01/05)
Changed the version of CodeWarrior (with the exception of one section) used in the build for the NITRO-DWC package to 2.0 SP1.
See Known issues in NITRO-DWC [-DL] 2.0 PR for information about the section that was not changed.
The CodeWarrior version was not changed to 2.0 SP1 in the AOSS/Easy Wireless Start Library used in the Wi-Fi Connection configuration, so only this section does not support the NITRO-SDK 4.0 series.
This problem is planned be corrected with the next version.
(2006/12/29)
Wi-Fi Connection Configuration now supports Korean language. DWC_LANGUAGE_HANGUL has been added to the languages that can be specified to the DWC_StartUtility and DWC_StartUtilityEx functions.
The following function for testing the Internet connection by communicating with a connection test server has been added.
Added the following functions for HTTP communications (GHTTP library).
DWC_GetGHTTPDataEx2 FunctionDWC_GHTTPPostAddFileFromMemory Function
The return value has been changed from void to BOOL, and now returns whether the download library shutdown process has started successfully. The sample demo dwc_nd_sample has also been changed to match this.
Although specifications have allowed NULL to be passed in the argument ptr representing the memory deallocation function specified to the DWC_SetMemFunc function, this has been absorbed by the library and no longer passes NULL in the argument ptr representing the memory deallocation function specified by the application.
The server URL used by the general-purpose ranking library has changed along with the new GameSpy server.
DWCRankingAdmin.exe)
All PIDs can now be deleted for the development server.
The URL of the GameSpy server has also changed.
A timeout has been added in order to handle cases where there is no response from the server because there was some code for which a timeout did not exist regarding communication with the GameSpy server during matchmaking.
An issue was found where an error code "0" was returned at disconnection of wireless link, and has been corrected.
A problem was corrected where the authentication server for products was being used by default before DWC_InitInet or DWC_InitInetEx function was called.
A problem has been corrected where the state obtained from the DWC_NASLoginProcess function would not change from DWC_NASLOGIN_STATE_IDLE and processing would not just end if a communication error occurred at a particular time after the authentication process was started by the DWC_NASLoginAsync function. Note that the state DWC_NASLOGIN_STATE_IDLE has been eliminated along with this revision.
A problem was corrected where execution would occasionally freeze during matchmaking involving a lot of people. Although this problem was likely to occur when matchmaking for four or more people, it would almost never occur when matchmaking for four people, but would increase in likelihood as the number of people would increase.
A problem was corrected where memory that should be freed by the DWC_ShutdownFriendsMatch function was not being freed when a communication error had occurred as a result of exceedingly poor signal quality after connecting to Wi-Fi Connection using DWC_LoginAsync.
A problem was corrected where the argument isChanged of the DWCUpdateServersCallback callback function was always TRUE when the data type for friend information was DWC_FRIENDDATA_LOGIN_ID regardless of whether the friend roster had been updated.
A problem was corrected where execution would stop when a communication error occurred during processing of the DWC_LoginToStorageServerAsync function.
This problem is caused by the HTTP communication (GHTTP) library. The problem was that a completion callback was not being invoked and memory was not being released when the DWC_CancelGHTTPRequest function was called. This was due to the fact that memory allocated when a request is issued (by DWC_GetGHTTPData, DWC_GetGHTTPDataEx, or DWC_PostGHTTPData) is released when a completion callback executes. This occurs even when the DWC_ShutdownGHTTP function is called without waiting for the completion callback. The above problem has been corrected so that operations are carried out correctly when canceling or releasing the library.
Finally, another problem with the DWC_GetGHTTPDataEx function has been corrected where the receive buffer was not released under the following conditions.
A problem was corrected where the DWC_NdCleanupAsync function could not be called (an assert would occur if called) if an error occurred during asynchronous processing of the DWC_NdInitAsync function, regardless of whether the library had already allocated memory.
A note has been added to the function reference in question regarding releasing the library.
The socket close operation was accessing an already deallocated memory area, and has been corrected.
The socket was not being closed when a cancel was called between server connection completion and data transmission in the download library. This issue was corrected.
Corrected an issue with the Wi-Fi Connection setting where closing the DS unit during AOSS setting generated an abnormal sound from headphones.
Although DS download play can be used when moving Wi-Fi user information using Wi-Fi Connection Configuration, a problem has been corrected when a child would disconnect upon downloading data and attempt to restart where the parent device would sometimes have to continue waiting because it could not detect this state.
An issue has been corrected where including dwc.h will define generic names such as print/vprintf/SCREEN_WIDTH/SCREEN_HEIGHT.
Parts of source code that were using character codes other than SJIS have been revised to use SJIS.
Parts of code that used OS_Free to release the receive buffer for ghttp_sample has been revised to use DWC_Free(). Processing performed when an error occurs with dwc_nd_sample has been revised. In addition, a description regarding temporary operations of the Download Server has been deleted from readme.txt. A problem with handling user-defined data regarding rank_sample has been corrected.
We made revisions to each programming manual included in $NITRODWC_ROOT/docs.
For details, see the revision history of each document in question.
None.
(2006/08/02)
Up until now, the security level was lowered in order to connect to the temporary download server. However, the actual working server is up now, so security has been improved.
We added the error code 540XX (the final two digits indicate the type of access point connected to) when disconnecting from an access point.
We fixed a bug that was causing problems in the error code set when using the DWC_UpdateConnection function to detect a disconnection from an access point.
A problem was corrected where a callback was not generated when an error occurred with the DWC_LoginToStorageServerAsync function.
ARM9-TS-inet.lsf that was not used in rank_sample.dwc_sample so that a text animation is displayed while running.dwc_connect_inet so that the DWC_UpdateConnection function is used to confirm connections to access points.
Revisions were made to the following documents contained in $NITRODWC_ROOT/docs: For details, see the revision history in the respective documents:
"Nintendo Wi-Fi Connection NITRO-DWC Programming Manual"
"Nintendo Wi-Fi Connection NITRO-DWC Programming Manual -Download Edition-"
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition-"
DWC_Base64Decode functionDWC_Base64Encode functionDWC_CheckUserData functionDWC_Debug_DWCInitError functionDWC_DebugConnectInetAsync functionDWC_GetLastError* functionDWC_Init functionDWC_IsEqualFriendData functionDWC_LoadOthersDataAsync functionDWC_LoginAsync functionDWC_NASLoginAbort functionDWC_NASLoginAsync functionDWC_NASLoginProcess functionDWC_NdCancelAsync functionDWC_NdCleanupAsync functionDWC_NdGetFileAsync functionDWC_NdGetFileListAsync functionDWC_NdGetFileListNumAsync functionDWC_NdGetProgress functionDWC_NdInitAsync functionDWC_NdSetAttr functionDWCNasLoginState functionDWCNdCallback functionDWCNdFileInfo functionDWC_ProcessFriendsMatch functionDWC_ProcessGHTTP functionDWC_RnkGetScoreAsync functionDWC_RnkInitialize functionDWC_RnkPutScoreAsync functionDWC_RnkResGetOrder functionDWC_RnkResGetRow functionDWC_RnkResGetRowCount functionDWC_RnkResGetTotal functionDWCRnkData functionDWCRnkError functionDWCRnkGetMode functionDWCRnkGetParam functionDWC_SetReportLevel functionDWC_UpdateConnection function
We fixed a bug where user-defined data could not be obtained normally.
Version 1.00 --> Version 1.01
None.
(2006/07/03)
We added the function DWC_NASLogin*, which performs the verification process for Nintendo Authentication. Up until now, this process had been performed inside the DWC_LoginAsync function, but when FriendsMatch Library features such as friend management and matchmaking are not in use, this function performs the authentication process instead.
We have added the dwc_naslogin_sample sample demo in accordance with these changes.
Note: Since the FriendsMatch Library is not included in NITRO-DWC-DL, the authentication process must be performed with this function.
We added a function to check that a connection to an access point is being maintained normally. Up until now, this process had been performed inside the DWC_ProcessFriendsMatch function, but when FriendsMatch Library features such as friend management and matchmaking are not in use, this function performs the connection check instead.
Note: Since the FriendsMatch Library is not included in NITRO-DWC-DL, the connection check must be performed with this function.
Up until now, the game name "gmtest" has been used in the sample demo. However, since developers who had been generally using GameSpy were using it as a shared name, it was possible that using this name could give a glimpse into the information about games in development and that data on a back-end server could be unexpectedly altered. Because of this issue, we have changed the name exclusively for the NITRO-DWC sample demo to "dwctest".
Since the functions GX_SetBGScrOffset and GX_SetBGCharOffset were not being called explicitly when initializing a Wi-Fi connection configuration, there was a bug where the screen display was becoming corrupted when changes were made to offsets with these functions. This bug has been fixed.
DWC_GetDateTime functionDWC_GetGHTTPState functionDWC_GetLastError* functionDWC_LoginAsync functionDWC_ProcessFriendsMatch functionDWC_SetConnectApType functionDWC_SetReportLevel functionDWC_UpdateConnection functionNone.
(2006/06/22)
The DWCBuddyFriendCallback function, which is called when a friend relationship is established, will now be called when the network communication used to establish the friend relationship is successful. This network communication used to establish the friend relationship may be performed twice, depending on the timing. Should that happen, the callback will have occurred each time.
We have made changes so that the the callback is not called when a friend relationship is already established.
We have revised the process for making an automatic connection to the Internet for access point authentication processes in order to improve connectivity to access points that accept only open system authentications.
Revisions were made to the following documents contained in $NITRODWC_ROOT/docs: For details, see the Revision History for each document.
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Version -
DWC_GetLastError* functionDWC_NdGetFileAsync functionDWC_RnkGetScoreAsync functionDWC_RnkGetState functionDWC_RnkPutScoreAsync functionDWC_SetupGameServer functionDWC_SetupGameServerAsync functionDWCRnkError functionWe added user-defined data to the CRC, and made changes to check for falsification.
We made changes for when user-defined data is not used in the general purpose ranking library. Users can now select NULL as the data argument and 0 for the size in the DWC_RnkPutScoreAsync function.
We fixed the issue where the program will stop due to an insufficient receive buffer when the download server returns an error.
Along with this fix was an addition of error code 31030 for an insufficient receive buffer error. Also, the minimum buffer size passed to DWC_NdGetFileAsync was set to 128 bytes. A buffer of at least 128 bytes will need to be specified, even if the downloaded data is smaller than this size.
None.
(2006/06/08)
We made changes to the internal operations of the process for obtaining service locator information that the download feature uses.
None.
(2006/06/06)
Added general-purpose ranking constants.
For details, see the documentation in $NITRODWC_ROOT/docs.
Added the library for downloading content from the Download server provided by Nintendo.
For details, see the documentation in $NITRODWC_ROOT/docs.
Made the following additions and changes to the error information that can be obtained with DWC_GetLastError and DWC_GetLastErrorEx:
DWCErrorType) and error kind (DWCError).DWC_ERROR_GHTTP_ANY) and error type (DWC_ETYPE_SHUTDOWN_GHTTP) for errors relating to HTTP communications (GameSpy HTTP).When FREESPOT was set for the SSID of connection targets 1 to 3 in the Settings Utility and a connection test was performed, the error that occurred had the error code is 5XX05, whereas it should have been some error code between 5XX00 and 5XX02. That problem has been fixed.
When the end user saved owner information to the DS and entered a nickname with 10 characters, an error code 20109 would be generated when connecting to Wi-Fi Connection. That problem has been corrected.
Note: This problem does not arise in NITRO-DWC 1.0 and later versions.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS patch.
When matchmaking was started after disconnecting during a game, sometimes that matchmaking process would not end. That problem has been fixed.
This problem occurred when the Reception state of Reliable transmission was to reset after peer-to-peer communications was disconnected.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS patch.
The Reception timeout callback specified by the DWC_SetUserRecvTimeoutCallback function was not being called. This problem was corrected.
Data sent using DWC_SendReliable* would accumulate in the Send buffer because there was no acknowledgment confirming reception by the receiver side. While the Send buffer remained full in this way, there would be no call to the Reception timeout callback.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS2 patch.
When connecting at a hotspot, the required information would not be sent to the Authentication server. This problem has been fixed.
This problem made it impossible to connect at some hotspots.
Note: This problem does not arise in NITRO-DWC 1.0 and later versions.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS2 patch.
The screen name in the game that gets sent to the Authentication server using the DWC_LoginAsync function has been extended to 25 characters. Before the maximum length was 10 characters.
In accordance, changes and additions were made to the explanation for the ingamesn argument of the DWC_LoginAsync function in the Reference Manual.
Note: This change is made by the NITRO-DWC 1.1 PLUS2.
The following three functions:
DWC_UpdateServerAsync functionDWC_SetFriendStatusCallback functionDWC_SetFriendStatusCallback functionDWCFriendStatusCallback functionDWCBuddyFriendCallback functionDWCFriendStatusCallback function, when -1 was set for the value of the 'index' argument, the other arguments (status/statusString) would also be abnormal.
Revised the 'Nintendo Wi-Fi Connection NITRO-DWC Programming Manual' included in $NITRODWC_ROOT/docs.
Also made additions to the Programming Manual for the general-purpose ranking feature and the download feature.
Additions and revisions were made to the items listed below. For details, see the Revision History for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.
DWC_AddCommonKeyValueString functionDWC_AddMatchKey* functionDWC_Base64Encode functionDWC_CleanupInet functionDWC_CleanupInetAsync functionDWC_ClearError functionDWC_ConnectInetAsync functionDWC_ConnectToAnybodyAsync functionDWC_ConnectToFriendsAsync functionDWC_DebugConnectInetAsync functionDWC_GetCommonValueString functionDWC_GetFriendStatus functionDWC_GetFriendStatusSC functionDWC_GetInetStatus functionDWC_GetIngamesnCheckResult functionDWC_GetLastError* functionDWC_GetMatch*Value functionDWC_GetOwnStatusString functionDWC_GHTTPPostAddString functionDWC_Init functionDWC_InitFriendsMatch functionDWC_InitInet functionDWC_LoadOthersDataAsync functionDWC_LoadOwnPrivateDataAsync functionDWC_LoadOwnPublicDataAsync functionDWC_LoginAsync functionDWC_NdCancelAsync functionDWC_NdCleanupAsync functionDWC_NdGetFileAsync functionDWC_NdGetFileListAsync functionDWC_NdGetFileListNumAsync functionDWC_NdGetProgress functionDWC_NdInitAsync functionDWC_NdSetAttr functionDWC_ProcessFriendsMatch functionDWC_ProcessInet functionDWC_Rnk_Constant_Number functionDWC_RnkCancelProcess functionDWC_RnkGetScoreAsync functionDWC_RnkGetState functionDWC_RnkInitialize functionDWC_RnkProcess functionDWC_RnkPutScoreAsync functionDWC_RnkResGetOrder functionDWC_RnkResGetRow functionDWC_RnkResGetRowCount functionDWC_RnkResGetTotal functionDWC_RnkShutdown functionDWC_SavePrivateDataAsync functionDWC_SavePublicDataAsync functionDWC_SendReliable functionDWC_SendReliableBitmap functionDWC_SetCommonKeyValueString functionDWC_SetOwnStatusString functionDWCConnectionClosedCallback functionDWCEvalPlayerCallback functionDWCGHTTPCompletedCallback functionDWCLoginCallback functionDWCMatchedCallback functionDWCMatchedSCCallback functionDWCNdCallback functionDWCNdCallbackReason functionDWCNdCleanupCallback functionDWCNdError functionDWCNdFileInfo functionDWCRnkData functionDWCRnkError functionDWCRnkGetMode functionDWCRnkGetParam functionDWCRnkRegion functionDWCRnkState functionDWCStorageLoginCallback functionDWCUpdateServersCallback function
rank_sample.dwc_nd_sample.SVC_WaitVBlankIntr to OS_WaitVBlankIntr in all of the samples.dwc_connect_inet_sample.dwc_sample and friend_match so no problem occurs when a value that is not a multiple of four is set for GAME_MAX_FRIEND_LIST.ARM9-TS-inet.lsf from ghttp_sample.
Deleted the directory $NITRODWC_ROOT/add-ins from the package.
None.
(2006/03/10)
Added DWC_StopScMatchingAsync as a function to cancel server-client matchmaking.
Added DWC_CancelGHTTPRequest as a function to cancel HTTP communication.
Added DWC_GetApInfo as a function that gets data specific to the connected access point after completing an Internet connection. This function gets the connection candidate (targets 1 through 3, the Nintendo Wi-Fi USB Connector, etc.) to which the access point is connected and the access point's SSID and BSSID. In addition, location information can also be obtained for Wi-Fi Station connections.
Added the function DWC_GetDateTime for getting the current date and time in GMT based on the time information retrieved from the authentication server during authentication processing. This function can also be used to get the GMT date and time after authentication. Be aware that there may be discrepancies in minute/second units.
The DWC_SetConnectApType function was added to explicitly set the target connection candidate (targets 1 through 3, the Nintendo Wi-Fi Station, etc.) before connecting to the Internet. The DWC_ConnectInetAsync function, which then runs, will only connect to the specified candidate. Use this function for debugging. This specification will be ignored in the FINALROM version.
If this function is used instead of DWC_ConnectInetAsync when connecting to the Internet, you can explicitly specify the SSIP and WEP key for the access point. Use this function for debugging.
This simple demo shows the process for connecting to the Internet. It also includes a demo for the new functions DWC_SetConnectApType and DWC_DebugConnectInetAsync.
If an attempt to set a value larger than that defined in DWC_TRANSPORT_SEND_MAX was made, the value was reset to DWC_TRANSPORT_SEND_MAX and TRUE was returned; this was changed to use assert processing.
Several revisions were made to the displayed message when the test fails during Wi-Fi connection settings.
The Wi-Fi User Data Migration Device Program included in the Wi-Fi connection settings was updated with a NITRO-SDK 3.0 build version.
Fixed an issue where the sound effect would loop while the B button was pressed when cancelling the AOSS settings in the Wi-Fi connection settings.
Fixed an issue where the connection test failure would stop for the Nintendo Wi-Fi USB Connector in the Wi-Fi Connection Settings.
Note: The connection test used in the Wi-Fi connection settings is the same as the Internet auto-connect process used in games.
Fixed an issue where a very long URL for hotspot authentication would result in a connection stop, while connecting to a hotspot for an Internet connection.
Fixed an issue where a freeze would occur when the DWC_GetInetStatus function was called between the DWC_InitInet and DWC_ConnectInetAsync function calls.
Fixed an issue where a freeze would occur if DWC_ProcessInet was called when the auto-connect control object for an Internet connection was still uninitialized (DWC_InitInet had not been called).
Fixed an issue where a freeze would occur when the DWC_CleanupInet function was called between the DWC_InitInet and DWC_ConnectInetAsync function calls.
Revised the random number generation method used when creating user data. Because the tick value was used as the random seed, if the OS_InitTick function is called with the same timing as the DWC_CreateUserData function, the same login ID can be created. To fix this, the base value for the random seed was changed to use the OS_GetLowEntropyData function.
Unused files and unnecessary notes were deleted.
The content of the User Data Management and Friend Connection Overview documentation was moved to the Programming Guidelines and NITRO-DWC Programming Manual. The original document was removed.
Supplemental descriptions were added to the NITRO-DWC Programming Manual and Function Reference.
None.
(2006/01/30)
DWC_SetFriendStatusCallback was added to configure the callback functions that are called when a friend's communication state changes.
The above callback functions are usually set as the arguments of the friend list synchronous process function DWC_UpdateServersAsync. But, even when no friend list synchronous process is needed and there is a need to know the friend's communication state in real time, use this function to configure the callback functions.
There was a bug where TRUE was returned when the DWC_IsSendableReliable function was called but FALSE was returned when the DWC_SendReliable* function was called during the generation of an error.
This bug has been fixed so that the DWC_IsSendableReliable function will return FALSE in this kind of situation.
The maximum number of people that can connect with matchmaking in the DWC Library is 32, so an ASSERT was added that checks whether the arguments of the DWC_ConnectToAnybodyAsync, DWC_ConnectToFriendsAsync, and DWC_SetupGameServer functions exceed this number.
The maximum number of friends that the DWC Library can handle is 64, so an ASSERT was added that checks whether the friend list length arguments of the DWC_InitFriendsMatch and DWC_ConnectToFriendsAsync functions exceed this number.
No DWC error was set when a memory allocation error occurred inside the DWC_SetSendDelay, DWC_SetRecvDelay, DWC_SetSendDrop, and DWC_SetRecvDrop functions.
This is revised so the DWC_ECODE_TYPE_ALLOC FATAL ERROR is properly set.
Added return values for failures to the GHTTP library functions below:
DWC_ProcessGHTTP: Previously, TRUE was always returned. It was changed so now FALSE is returned when an error is generated.
DWC_GHTTPPostAddString: Previously, this had no return value. It now returns FALSE when there is a parameter error or a memory allocation error.
DWC_PostGHTTPData: Previously, if this function was called when an error was generated, it was allowed to process normally. It now does nothing and returns the new error DWC_GHTTP_IN_ERROR.
DWC_GetGHTTPData: Previously, if this function was called when an error was being generated, it was allowed to process normally. It now does nothing and returns the new error DWC_GHTTP_IN_ERROR.
DWC_GetGHTTPDataEx: Previously, if this function was called when an error was being generated, it was allowed to process normally. It now does nothing and returns the new error DWC_GHTTP_IN_ERROR.
DWC_InitFriendsMatch function is called, they will not return FALSE.DWC_SetSendDrop, DWC_SetRecvDrop, DWC_SetSendDelay, DWC_SetRecvDelay, and DWC_Ping functions, failures to allocate memory and designations of invalid AIDs will cause the functions to fail.
The function DWC_Base64Encode (used to encode Base 64) and the function DWC_Base64Decode (used to decode Base 64) were added.
Previously, when status data was configured with the DWC_SetOwnStatusData function, the character string for the statusString argument of the friend state change notification callback DWCFriendStatusCallback could not be used. However, if the DWC_Base64Decode function is used, the statusString character string (a Base 64 character string) will be decoded and can be referenced.
During matchmaking, a temporary parent-child relationship is formed between connected DS devices.
There was a bug where, if the network fails due to a reason such as the power being cut off on the parent DS, any connected child DS devices would freeze up (but matchmaking could be cancelled).
This bug has been fixed so, that should this sort of situation occur and a child DS cannot communicate with its parent for a fixed amount of time, it will re-attempt matchmaking.
The DWC_CheckFriendKey function was being used to check the validity of friend registration keys on the CRC. However, there was a bug that was generating parameter errors during the friend list synchronous process. This occurred even though this function returned TRUE when the GS profile ID included in the friend registration key was negative and a correct friend registration key was input into the CRC.
This has been fixed so that a FALSE will return for friend registration keys whose GS profile ID is negative.
The DWC_LoadOwnDataAsync function, which loaded your data from a data storage server, was unable to load anything except Private data.
Therefore, the following functions have been added: the DWC_LoadOwnPublicDataAsync function, which loads Public data, and the DWC_LoadOwnPrivateDataAsync function, which loads Private data.
There was a bug where, even though a FALSE was specified in the distantFriend argument of the DWC_ConnectToFriendsAsync function, a connection would be made with friends outside of what was specified in the friendIdxList argument.
This bug was fixed so that if a FALSE is specified for distantFriend, there will only be connections made with those friends specified in friendIdxList (or all friends if friendIdxList=NULL).
A bug existed where, after the networking state became unstable and a DWC error was generated, the internal process would continue and fatal error code 71002 would be generated.
This was fixed so that the fatal error does not occur.
Changes were made so that the sample source comments and the terminology used in the reference are consistent.
Specifically, "matching", which was forbidden from being used in the glossary, was changed to "matchmaking".
The following revisions were made to the $NITRODWC_ROOT/build/demos/dwc_frienddata_sample and $NITRODWC_ROOT/build/demos/dwc_friend_match_sample demos.
s_logined=TRUE (the process that determines a completed connection to the Wi-Fi Connection). The description within the cb_login function was erroneous, so it was deleted.
The following revision was made to the $NITRODWC_ROOT/build/demos/dwc_sample demo:
None.
Software Development Support Group
CONFIDENTIAL