nn::applet::CTR::WaitForStarting Function

Syntax

AppletWakeupState WaitForStarting(
AppletId * pSenderId = NULL,
u8 * pParam = NULL,
size_t paramSize = 0,
s32 * pReadLen = NULL,
nn::Handle * pHandle = NULL,
nn::fnd::TimeSpan timeout = NN_APPLET_WAIT_INFINITE
);

Arguments

Name Description
out pSenderId ID of the Applet that sent the event.
out pParam Parameter buffer.
in paramSize Parameter buffer size.
out pReadLen Amount of data to read.
out pHandle Handler.
in timeout Timeout interval.

Return Values

Returns the reason that processing was resumed.

Description

Waits for this object's start event.

This function returns until the start event is received. This function returns a value from the AppletWakeupState enumerated type. The program must decide how to respond based on this value (whether to resume normally or exit).

For example, the application must be closed immediately when nn::applet::CTR::WAKEUP_BY_CANCEL is received.

When a press of the POWER button is detected (when IsExpectedToProcessPowerButton() == true) the application must be exited, regardless of the return value.

Also, if the application continues running after the button press, to release the HOME button transition lock and other transition locks, the ClearHomeButtonState() function must be called. (See the ClearHomeButtonState() topic for details.)

Revision History

2010/11/10
Initial version.

CONFIDENTIAL