WM_SetGameInfo

Syntax

#include <nitro/wm.h>

WMErrCode WM_SetGameInfo(
        WMCallbackFunc  callback ,
        const u16*      userGameInfo ,
        u16             userGameInfoSize ,
        u32             ggid,
        u16             tgid,
        u8              attr
);

Arguments

callback Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
userGameInfo Specifies the pointer to user game information.
userGameInfoSize Specifies the size of user game information. A maximum of 112 bytes can be specified.
ggid Specifies the game group ID.
tgid Specifies a temporary group ID.
attr Specifies attributes such as: receiving entry and DS download play permitted.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Reconfigures the game-specific information sent out by the beacon. This function can be executed only if the WM is in the PARENT or MP_PARENT state. If the return value is WM_ERRCODE_OPERATING, a callback is generated after the information reconfiguration process is complete. The WM_SetParentParameter function sets the initial values, and this function modifies the values.

The argument attr is expressed as the logical sum of the following:

WM_ATTR_FLAG_ENTRY "Receiving entry" flag
WM_ATTR_FLAG_MB "Download play possible" flag
WM_ATTR_FLAG_KS Key sharing.Not currently used. (Note: Be sure to disable this bit.)
WM_ATTR_FLAG_CS Continuation communication mode.Not currently used.

See Also

WM_SetParentParameter
WM_StartParent

Revision History

2008/12/18 Deleted a mistake in the description of arguments.
2006/02/20 Changed argument names.
2005/12/08 Deleted a description of the cache ring.
2005/06/08 Added the fact that the callback is called from the interrupt handler.
2004/10/22 Changed the type of return values.
2004/09/24 Added to and revised the Description.
2004/08/02 Standardized structure names.
2004/07/29 Made additions to the Description.
2004/07/23 Initial version.


CONFIDENTIAL