DosTimerAsync

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:
• 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.

  ---

  [Back: DosSuspendThread]
  [Next: DosTimerStart]