

#include <nitro/os.h>
void OS_SetOneTimeVAlarm(
OSVAlarm* alarm ,
s16 count ,
OSVAlarmHandler handler ,
void* arg );
| alarm | Pointer to the V-Count alarm structure for setting V-Count alarm |
| count | The V-Count value at which the V-Count alarm is actuated (the handler is called) |
| handler | The V-Count alarm handler |
| arg | The argument when calling the V-Count alarm handler |
None.
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 );
is the inline version of
OS_SetVAlarm( alarm, count, 10, handler, arg );
For more details, see OS_SetVAlarm() or OS_InitVAlarm().
2004/10/22 Initial version.
CONFIDENTIAL