DWC_NdInitAsync

Syntax

#include <dwc.h>

BOOL DWC_NdInitAsync(DWCNdCallback callback,
                     const char *gamecd,
                     const char *passwd);

Arguments

callback Pointer to the callback function called in response to various types of notifications from the Download library. If a callback is unnecessary, specify NULL.
gamecd Pointer to the game name required to access Nintendo Wi-Fi Connection Download Server.
passwd Pointer to the password string required to access Nintendo Wi-Fi Connection Download Server.

Return Values

TRUE Successful. The DWC_NdCleanupAsync function must be called at termination.
FALSE Failed. Use the DWC_GetLastErrorEx function to obtain error information.

Description

Starts the process of download library initialization.

Because HTTP communications are performed in the background during initialization, be sure that enough processing time is given to run threads that have lower priority than the main thread.
Two types of download servers are available: one for development and one for the final product. The download server is switched, along with the authentication server, by the DWC_Init function.

To obtain the information to be specified as the gamecd and passwd arguments, you must apply to Nintendo ahead of time.

Once this function is called and TRUE is returned, be sure to call the DWC_NdProcess function about once per game frame to advance processing. Because the download library starts up when TRUE is returned, the DWC_NdCleanupAsync function must be called even if an error occurs during asynchronous initialization processing.

The value returned by DWC_NdProcess allows you to determine when initialization has completed. If you specify callback, the specified callback function will be called when the initialization process completes.

This function calls the NHTTPStartup function internally. Avoid the overlapping use of NHTTP before and after the time interval between the call to this function and the time that the processes performed by DWC_NdCleanupAsync are completed.

See Also

DWC_Init
DWC_GetLastErrorEx
DWC_NdProcess

Revision History

1.4.15
Added callback to the arguments.
1.4.12
Added information specific to conflicts in NHTTP.
1.4.7
Added a description of usage.

CONFIDENTIAL