DosTimerAsync

Bindings:  C, MASM 

This call starts a timer that runs asynchronously to the thread issuing 
the request and clears a system semaphore when the specified interval 
expires. 

 DosTimerAsync     (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 
    DosTimerAsync is called. 

 Handle (PHTIMER) - output 
    Address of the timer handle. This handle may be passed to DosTimerStop 
    to stop this timer before its time interval expires. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    323       ERROR_TS_SEMHANDLE 
    324       ERROR_TS_NOTIMER 
 
 Remarks 

 DosTimerAsync is used to wait for a single asynchronous time.  The thread 
 waits for the time out by issuing a DosSemWait. 

 This function is the asynchronous analog of DosSleep. This function 
 allows a thread to start a timer while it is performing another task. 
 This timer can be canceled by calling the DosTimerStop function with the 
 timer handle returned by DosTimerAsync. 

 If another time out is needed, the semaphore is set and DosTimerAsync is 
 reissued. To ensure reliable detection of the timer expiration, the 
 system semaphore should be set prior to calling DosTimerAsync. 

 To set a periodic interval timer, see DosTimerStart.