# WaitUntil

Waits for a given amount of time to pass.

### Synopsis

`Err WaitTime(Item ioreq, uint32 seconds, uint32 micros);`

### Description

Puts the current context to sleep until the system clock reaches a given time.

### Arguments

ioreq
  An active timer device I/O request, as obtained from CreateTimerIOReq().

seconds
  The seconds value that the timer must reach.

micros
  The microseconds value that the timer must reach.

### Return Value

Returns >= 0 for success, or a negative error code for failure.

### Implementation

Convenience call implemented in clib.lib V24.

### Associated Files

time.h, clib.lib

### See Also

``CreateTimerIOReq`(), DeleteTimerIOReq(), WaitTime()`