zx_clock_get_details

摘要

擷取時鐘目前狀態的所有低階詳細資訊。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_clock_get_details(zx_handle_t handle,
                                 uint64_t options,
                                 void* details);

權限

handle 必須是 ZX_OBJ_TYPE_CLOCK 類型，且具有 ZX_RIGHT_READ。

說明

擷取時鐘物件的精細詳細資料。如要瞭解報告詳細資料的具體細節，請參閱偽裝一節。目前，只有時鐘 zx_clock_details_v1_t 定義了一個詳細資料結構。使用者必須使用選項參數指定結構版本，並透過 details 提供至少 sizeof(zx_clock_details_v1_t) 個位元組的儲存空間。例如：

#include <zircon/syscalls.h>
#include <zircon/syscalls/clock.h>

void GetSomeDetails(zx_handle_t the_clock) {
  zx_clock_details_v1_t details;
  zx_status_t status;

  status = zx_clock_get_details(the_clock, ZX_CLOCK_ARGS_VERSION(1), &details);
  if (status == ZX_OK) {
    // Do great things with our details.
  }
}

傳回值

成功時，會傳回 ZX_OK 以及儲存在 detailsout 參數中的時鐘詳細資料。

錯誤

  • ZX_ERR_BAD_HANDLE：控制代碼是無效控制代碼，或是非 ZX_OBJ_TYPE_CLOCK 物件類型的控制代碼。
  • ZX_ERR_ACCESS_DENIED：處理常式缺少 ZX_RIGHT_READ。
  • ZX_ERR_INVALID_ARGS：options 訊號的詳細資料結構版本無效，或者透過 details 傳遞的結構指標無效。

另請參閱