DWC_InitInet

C Specification

#include <dwc.h>

void DWC_InitInet  ( DWCInetControl* inetCntl );

void DWC_InitInetEx( DWCInetControl* inetCntl,
                     u16 dmaNo,
                     u16 powerMode,
                     u16 ssl_priority );

Description

This function initializes the automatic connection control object specified by inetCntl. In the application, prepare a buffer that is the same size as the DWCInetControl structure.

Maintain the buffer for the automatic connection control object until the connection state is released using the DWC_CleanupInet function.

By default, the development-use authentication server is used. To use the production authentication server, call the DWC_SetAuthServer function immediately after this function.

In the DWC_InitInetEx function, you can configure the DMA number used by the automatic connection operation, the WM power mode, and the SSL operation thread priority. However, always set the WM power mode to 1.
The DWC_InitInet function sets the arguments within the library to dma=3, powerMode=1, and ssl_priority=20, and calls the DWC_InitInetEx function.

Because the SSL operation takes time, its priority must be made lower than that of the main thread otherwise it will affect the operation of the main thread.

Arguments

inetCntl Pointer to the automatic connection control object.
dmaNo DMA number used by the automatic connection operation.
powerMode The WM power mode in the automatic connection operation. Always set to 1.
ssl_priority SSL operation thread priority.

Return Values

None.

See Also

DWC_CheckInet, DWC_ProcessInet, DWC_GetInetStatus, DWC_CleanupInet, DWC_CleanupInetAsync

Revision History

12/16/2005 Added an explanation of the DWC_InitInetEx function
10/26/2005 Revised
07/22/2005 Initial version