#include <nitro/os.h>
void OS_SetOneTimeVAlarm(
OSVAlarm* alarm ,
s16 count ,
OSVAlarmHandler handler ,
void* arg );
This function configures a one-shot V count alarm.
It is meant to give compatibility with OS_SetVAlarm() prior to NITRO-SDK 2.0 RC1.
In the old format of OS_SetVAlarm(), the function took four arguments (the pointer to the alarm structure, the V count, the handler, and the handler's argument). Now that the delay value can be specified, the function has five arguments. For this reason, the OS_SetOneTimeVAlarm() function has been prepared for times when you want to configure the V alarm with the old-format arguments. Although this function does not have the delay argument, it operates internally as if delay = 10.
OS_SetOneTimeVAlarm( alarm , count , handler , arg );
becomes inline as:
OS_SetVAlarm( alarm , count , 10 , handler , arg );
For more details, see OS_SetVAlarm() or OS_InitVAlarm().
alarm |
Pointer to the V count alarm structure for setting V count alarm |
count |
The V count value invoked by the V count alarm (called by the handler) |
handler |
The V count alarm handler |
arg |
The argument when calling the V count alarm handler |
None
OS_SetVAlarm(), OS_InitVAlarm()
2004/10/22 Initial version