zx_clock_get


英文原文快照


名称

clock_get —— 获取当前时间。

概要

  1. #include <zircon/syscalls.h>
  2. zx_status_t zx_clock_get_new(uint32_t clock_id, zx_time_t* out_time);
  3. zx_time_t zx_clock_get(zx_clock_t clock_id);

描述

zx_clock_get() 返回clock_id的当前时间,如果clock_id无效,则返回0。

zx_clock_get_new() 通过out_time返回clock_id类型的当前时间,以及clock_id是否有效。

支持的CLOCK ID

ZX_CLOCK_MONOTONIC:自系统启动以来的纳秒数。 ZX_CLOCK_UTC:自Unix epoch(即1970年1月1日0时 UTC+0)以来的wall clock时钟已经历的纳秒数。

ZX_CLOCK_THREAD:当前线程已运行的纳秒数。

权限

TODO(ZX-2399)

返回值

zx_clock_get() 执行成功,则根据给定的时钟ID返回当前时间。

zx_clock_get_new() 执行成功返回ZX_OK

错误码

执行出错时,zx_clock_get() 当前返回0。

ZX_ERR_INVALID_ARGSclock_id是无效的时钟ID,或out_time是无效指针。