SL_StartNewTimerRequest


NAME
SL_StartNewTimerRequest -- Allocates, inits, and starts a new timer request.

SYNOPSIS
timehandle = SL_StartNewTimerRequest(apphandle, date, time, flags, userdata);
D0 A0 D0 D1 D2 D3

TIMEHANDLE SL_StartNewTimerRequest(APPHANDLE, ULONG, ULONG, ULONG, SLTAGDATA);

FUNCTION
When a timehandle elapses an AppMsg is sent to the application's app
callback. The message type is APPMSG_TIMER. The data is the userdata
as passed to this function. The timehandle is freed and ended when
this message is generated so there is no need to call SL_EndTimerRequest
on it.If the timehandle is repeating, the time request is automatically
reposted when it elapses. These types of requests must be ended.

INPUTS
apphandle - as returned by SL_AppInitA.
date - the date of the request (in the format YYYYMMDD - see SL_GetDate).
time - the time of the request (in the format HHMMSSII - see SL_GetTime).
flags - any of the TIMERFLG_xxx flags.
TIMEFLG_RELATIVE - the date and time are relative to the
current time.
TIMEFLG_REPEAT - the request will be repeated (only valid
for TIMEFLG_RELATIVE).
userdata - any SLTAGDATA value the user wants. This will be sent back to
the app in the AppMsg->data field when this request elapses.

SEE ALSO
SL_EndTimerRequest, SL_GetTime, SL_GetDate, Callback-Application.

 

SL_StartNewTimerRequest  Command Section By Type  url:SL_StartNewTimerRequest
  created:2008-03-01 23:36:35   last updated:2008-03-01 23:36:35
  Copyright © 1985-2017 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For SL_StartNewTimerRequest
There are no user contributed comments for this page.