DosTimerStart
Bindings: C, MASM
This call starts a periodic interval timer that runs asynchronously to the
thread issuing the request. The semaphore is continually cleared at the
specified time interval until the timer is turned off by DosTimerStop.
DosTimerStart (TimeInterval, SemHandle, Handle)
TimeInterval (ULONG) - input
Number of milliseconds (rounded up to the next clock tick) that passes
before the semaphore is cleared.
SemHandle (HSEM) - input
Handle of the system semaphore used to communicate the time out to the
calling thread. This semaphore should be set by DosSemSet before the
next clear by the timer.
Handle (PHTIMER) - output
Address of the timer handle. This handle may be passed to DosTimerStop
to stop the periodic timer.
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
323 ERROR_TS_SEMHANDLE
324 ERROR_TS_NOTIMER
Remarks
DosTimerStart allows a timer to start and run asynchronously to a thread.
A timer interval is canceled by using the timer handle in the
DosTimerStop call. This prevents the semaphore indicated in the
DosTimerStart call from being sent notifications.
The application detects the expirations of the timer when the semaphore
is set prior to the next expiration of the timer. When an application
waits for this semaphore to clear, more than one clearing of the timer
may occur before the application resumes execution. If it is necessary
to determine the actual elapsed time, the Global Information Segment
milliseconds field can be saved by a DosGetInfoSeg request before calling
DosTimerStart. This saved value is compared to the current value when
the process resumes.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs