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() 呼叫傳回的值。
  • 指向時鐘狀態的指標，該狀態已部分或完全未對應。

會導致未定義的行為。

另請參閱