zx_clock_read_mapped

摘要

对映射时钟的状态执行基本读取。与对 zx_clock_read() 的调用完全相同，但它对映射时钟的状态（而非时钟句柄）进行操作，并且通常无需进入 Zircon 内核即可执行读取，因此可能会带来性能优势。如需了解详情，请参阅可映射的时钟。

声明

#include <zircon/syscalls.h>

zx_status_t zx_clock_read_mapped(const void* clock_addr, zx_time_t* now);

权限

无需句柄即可成功执行读取操作，因此也不需要任何特定的句柄权限。相反，用户必须提供当前有效的时钟状态映射的虚拟地址，该映射是使用 zx_vmar_map_clock() 建立的

说明

对时钟的映射状态执行基本读取，并在 now 输出参数中返回其当前时间。

返回值

成功时，在 now 输出参数中返回 ZX_OK 以及时钟的当前时间。

错误

任何尝试为 clock_addr 传递虚拟指针的操作：

  • 不是对 zx_clock_map() 的初始调用返回的值。
  • 指向已部分或完全取消映射的时钟状态的指针。

会导致未定义的行为。

另请参阅