Perform a basic read of the clock.
#include <zircon/syscalls.h> zx_status_t zx_clock_read(zx_handle_t handle, zx_time_t* now);
handle must be of type ZX_OBJ_TYPE_CLOCK and have ZX_RIGHT_READ.
Perform a basic read of the clock object and return its current time in the now out parameter.
On success, returns ZX_OK along with the clock's current time in the now output parameter.
- ZX_ERR_BAD_HANDLE : handle is either an invalid handle, or a handle to an object type which is not ZX_OBJ_TYPE_CLOCK.
- ZX_ERR_ACCESS_DENIED : handle lacks the ZX_RIGHT_READ right.
- ZX_ERR_BAD_STATE : The clock object has never been updated. No initial time has been established yet.