总结
取消计时器。
声明
#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()
之前调用此函数不会产生任何影响。