摘要
擷取已對應時鐘目前狀態的所有低層級詳細資料。與呼叫 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()
呼叫傳回的值。 - 指向時鐘狀態的指標,該狀態已部分或完全未對應。
會導致未定義的行為。