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 出參數中的時鐘詳細資料。

錯誤

任何嘗試為 clock_addr 傳遞虛擬指標的行為:

  • 不是原始對 zx_clock_map() 呼叫傳回的值。
  • 指向時鐘狀態的指標,該狀態已部分或完全未對應。

會導致未定義的行為。

另請參閱