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。使用者必須使用 options 參數以及至少提供 透過 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，以及儲存在詳細資料中的時鐘詳細資料 out 參數

錯誤

  • ZX_ERR_BAD_HANDLE：帳號代碼是無效的帳號代碼，或是 不是 ZX_OBJ_TYPE_CLOCK 的物件類型。
  • ZX_ERR_ACCESS_DENIED：帳號代碼缺少 ZX_RIGHT_READ 的右側。
  • ZX_ERR_INVALID_ARGS：發出信號的詳細資料結構版本 options 無效，或透過 details 傳遞的結構指標錯誤。

另請參閱