ProcUISetBucketStorage DEPRECATED

Syntax

#include <cafe/procui.h>

void ProcUISetBucketStorage(void* data, u32 size);

Parameters

data A pointer to the location to use. NULL disables save/restore.
size Size in bytes of the foreground bucket. Set this to 0 or the value returned by OSGetForegroundBucketFreeArea; otherwise you may raise an exception.

Return Values

None.

Description

Designates the area to use when saving and restoring the foreground bucket. NULL disables this feature.

You may restore the foreground bucket and MEM1 areas by using the ProcUISetBucketStorage and ProcUISetMEM1Storage functions. Using these functions have disadvantages in terms of memory usage and process-switching time.

If you are concerned about memory usage or process-switching time, Nintendo recommends that you do not use these functions. Instead, design your application so that it is acceptable for the foreground bucket and MEM1 to be corrupted after a process switch.

Do Not Call From

Deprecated Do not call this function in new code.
Background Do not call this function from the background.
Multiple threads This function is not thread-safe.

See Also

Process Switching and Shutdown Tips

Revision History

2013/05/08 Automated cleanup pass.
2012/08/21 Cleanup Pass
2012/05/04 Initial version.


CONFIDENTIAL