MPUpdateBeaconAsync

C Specification

#include <revolution/mp.h>
s32 MPUpdateBeaconAsync ( MPCallback cb, void* userData );

Arguments

cb Callback function to be called when an asynchronous function completes
userData Pointer value that is passed to the callback function and can be used at will in the application

Return Values

Returns the processing results or a negative number if processing fails.

Description

The current settings are referenced and the game information is asynchronously updated and sent. After a beacon is sent once after updating, cb is called.

In the previous implementation, the work region for the asynchronous function was passed as an argument, but this is no longer necessary. Instead, there is now a limit on the number of asynchronous functions that can be called at the same time. If this limit is exceeded, MP_RESULT_BUSY is given as the return value. In the present implementation, a total of 32 functions can be called at the same time, including both synchronous and asynchronous functions, from different MP libraries.

The pointer to the user data passed to the callback function is passed to the userData argument. The pointer value specified here is passed to the callback function without being evaluated inside the library, so it is all right to specify an illegal value.

See Also

MPSetUserGameInfo(), MPSetEntryFlag(), MPUpdateBeacon(), MPError, MPCallback, MPCallbackInfo

Revision History

2007/11/28 Corrected errors.
2007/10/03 Made revisions in line with change to final argument.
2006/08/22 Added a description of block.
2006/06/29 Initial version.


CONFIDENTIAL