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

錯誤

  • ZX_ERR_BAD_HANDLE：handle 是無效的 handle，或是非 ZX_OBJ_TYPE_CLOCK 的物件類型 handle。
  • ZX_ERR_ACCESS_DENIED：handle 缺少 ZX_RIGHT_READ 權限。
  • ZX_ERR_INVALID_ARGS：options 所傳送的詳細資料結構版本無效，或是透過 details 傳遞的結構體指標無效。

另請參閱