zx_clock_get_details

摘要

获取时钟当前状态的所有低级别详细信息。

声明

#include <zircon/syscalls.h>

zx_status_t zx_clock_get_details(zx_handle_t handle,
                                 uint64_t options,
                                 void* details);

权限

handle 的类型必须为 ZX_OBJ_TYPE_CLOCK 且包含 ZX_RIGHT_READ。

说明

获取时钟对象的精细详细信息。请参阅 时钟显示详细信息 被举报。目前只为时钟定义一种详情结构， zx_clock_details_v1_t。用户必须使用 options 参数，并且至少提供 通过 details 获得 sizeof(zx_clock_details_v1_t) 字节的存储空间。例如：

#include <zircon/syscalls.h>
#include <zircon/syscalls/clock.h>

void GetSomeDetails(zx_handle_t the_clock) {
  zx_clock_details_v1_t details;
  zx_status_t status;

  status = zx_clock_get_details(the_clock, ZX_CLOCK_ARGS_VERSION(1), &details);
  if (status == ZX_OK) {
    // Do great things with our details.
  }
}

返回值

成功后，将返回 ZX_OK 以及存储在 details 中的时钟详细信息 out 参数。

错误

  • ZX_ERR_BAD_HANDLE：handle 是无效句柄或 不是 ZX_OBJ_TYPE_CLOCK 的对象类型。
  • ZX_ERR_ACCESS_DENIED：handle 缺少 ZX_RIGHT_READ 右侧。
  • ZX_ERR_INVALID_ARGS：由 options 无效，或者通过 details 传递的结构的指针错误。

另请参阅