SOInit

Syntax

#include <revolution/so.h>
int SOInit( const SOLibraryConfig* config )

Description

Initializes the SO library. Call this function once before calling any function provided by the SO library.
Calling the SOInit function does not involve actual communication processing.

Arguments

config Specifies a pointer to the SOLibraryConfig structure that defined the function called by the SO library during allocation or deallocation of the dynamic work buffer.

Return Values

0 Process succeeded.
SO_EALREADY It has already been initialized with the SOInit function.
SO_EINVAL Either the pointer specified in config is invalid, or the function pointers specified in each field of config are invalid.
SO_ENOMEM Cannot allocate the required amount of memory for processing.

Note: Error codes other than those described above might be returned following subsequent library or console firmware updates. To deal with unexpected errors during development, treat all negative return values other than those described above as fatal errors, and either halt program execution or perform similar error handling.

See Also

SOFinish
SOStartup
SOStartupEx
SOLibraryConfig

Revision History

2008/05/19 Revised notes for error codes.
2007/01/31 Initial version.


CONFIDENTIAL