摘要
提取映射时钟当前状态的所有低级详细信息。与调用 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()
的初始调用返回的值。 - 指向已部分或完全取消映射的时钟状态的指针。
会导致未定义的行为。