zx_clock_get_details_mapped

摘要

提取映射时钟当前状态的所有低级详细信息。与调用 zx_clock_get_details() 的行为完全相同,但它对映射时钟的状态(而非时钟句柄)进行操作,并且通常无需进入 Zircon 内核即可执行观察,因此可能会带来性能优势。如需了解详情,请参阅可映射的时钟

声明

#include <zircon/syscalls.h>

zx_status_t zx_clock_get_details_mapped(const void* clock_addr,
                                        uint64_t options,
                                        void* details);

权限

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

说明

提取映射时钟状态的精细详细信息。请参阅时钟。如需了解详情(包括示例),请参阅 zx_clock_get_details() 的当前说明

返回值

如果成功,则返回 ZX_OK 以及存储在 details out 参数中的时钟详细信息。

错误

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

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

会导致未定义的行为。

另请参阅