摘要
取消計時器。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_timer_cancel(zx_handle_t handle);
說明
zx_timer_cancel()
會取消由 zx_timer_set()
啟動的待處理計時器。
成功後,系統會取消待處理計時器,並取消 ZX_TIMER_SIGNALED
信號。如需立即使用新的待處理計時器,而不是先呼叫 zx_timer_cancel()
,請使用新的期限呼叫 zx_timer_set()
。
權限
handle 必須是 ZX_OBJ_TYPE_TIMER
類型,且具有 ZX_RIGHT_WRITE
。
傳回值
zx_timer_cancel()
會在成功時傳回 ZX_OK
。如果失敗,系統會傳回負值錯誤值。
錯誤
ZX_ERR_BAD_HANDLE
帳號代碼不是有效的帳號代碼。
ZX_ERR_ACCESS_DENIED
處理常式缺少正確的 ZX_RIGHT_WRITE
。
記事
在 zx_timer_set()
之前呼叫此函式不會產生任何影響。