zx_timer_create

摘要

建立計時器。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_timer_create(uint32_t options,
                            zx_clock_t clock_id,
                            zx_handle_t* out);

說明

zx_timer_create() 會建立計時器，物件可在達到特定時間點時發出信號。唯一有效的 clock_id 為 ZX_CLOCK_MONOTONIC。

「options」值可指定合作行為，控管系統是否可以根據其他待處理計時器提早啟動時間。

可能的值如下：

  • ZX_TIMER_SLACK_CENTER
  • ZX_TIMER_SLACK_EARLY
  • ZX_TIMER_SLACK_LATE

在選項中傳遞 0 等同於 ZX_TIMER_SLACK_CENTER。

詳情請參閱計時器腳架。

傳回的帳號代碼具有 ZX_RIGHT_DUPLICATE、ZX_RIGHT_TRANSFER、ZX_RIGHT_WRITE、ZX_RIGHT_SIGNAL、ZX_RIGHT_WAIT 和 ZX_RIGHT_INSPECT 權限。

權限

呼叫端工作政策必須允許 ZX_POL_NEW_TIMER。

傳回值

zx_timer_create() 會在成功時傳回 ZX_OK。如果失敗，系統會傳回負值的錯誤值。

錯誤

ZX_ERR_INVALID_ARGS out 是無效指標或 NULL，或者 options 不是 ZX_TIMER_SLACK 值之一，或者 clock_id 是 ZX_CLOCK_MONOTONIC 以外的任何值。

ZX_ERR_NO_MEMORY 因記憶體不足而失敗。使用者空間無法以任何方式處理這個錯誤 (極可能) 錯誤。日後的建構作業不會再發生這個錯誤。

另請參閱